Log.WriteEntry Método

Definición

Espacio de nombres:: Microsoft.VisualBasic.Logging

Ensamblado:: Microsoft.VisualBasic.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Escribe un mensaje en los agentes de escucha de registro de la aplicación.

Sobrecargas

Nombre	Description
WriteEntry(String)	Escribe un mensaje en los agentes de escucha de registro de la aplicación.
WriteEntry(String, TraceEventType)	Escribe un mensaje en los agentes de escucha de registro de la aplicación.
WriteEntry(String, TraceEventType, Int32)	Escribe un mensaje en los agentes de escucha de registro de la aplicación.

WriteEntry(String)

Escribe un mensaje en los agentes de escucha de registro de la aplicación.

public:
 void WriteEntry(System::String ^ message);

public void WriteEntry(string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parámetros

message: String

Required. Mensaje que se va a registrar. Si message es Nothing, se usa una cadena vacía.

Excepciones

SecurityException

El código con confianza parcial llama al método , pero escribe en un agente de escucha de registro de eventos que requiere plena confianza.

Ejemplos

En este ejemplo se muestra cómo usar el My.Application.Log.WriteEntry método para registrar la información de seguimiento. Para obtener más información, vea Cómo: Escribir mensajes de registro.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Este ejemplo de código solo se puede ejecutar dentro de una aplicación cliente. Cambie My.Application.Log.WriteEntry a My.Log.WriteEntry para aplicaciones web.

Comentarios

El WriteEntry método escribe un mensaje en los agentes de escucha del registro de eventos de la aplicación.

En las aplicaciones cliente, el Log objeto está disponible a través del My.Application.Log objeto . En las aplicaciones web, el Log objeto está disponible a través del My.Log objeto .

Para obtener información sobre qué agentes de escucha de registro reciben los WriteEntry mensajes del método, consulte Tutorial: Determinar dónde escribe my.Application.Log información. Puede cambiar los agentes de escucha de registro predeterminados. Para obtener más información, consulte Trabajar con registros de aplicaciones.

En el caso de las sobrecargas que no toman el id argumento , el id objeto escrito en el registro se define en la tabla siguiente.

`severity`	Predeterminado `id`
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el WriteEntry método .

En	Vea
Escribir información de eventos en los agentes de escucha de registro de la aplicación	Cómo: Escribir mensajes de registro
Determinar dónde `Log` escribe información	Tutorial: Determinar el lugar en el que My.Application.Log escribe la información

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación Windows	Yes
Biblioteca de clases	Yes
Aplicación de consola	Yes
Biblioteca de controles de Windows	Yes
Biblioteca de controles web	No
Servicio de Windows	Yes
Sitio web	Yes

Consulte también

Se aplica a

WriteEntry(String, TraceEventType)

Escribe un mensaje en los agentes de escucha de registro de la aplicación.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity);

public void WriteEntry(string message, System.Diagnostics.TraceEventType severity);

member this.WriteEntry : string * System.Diagnostics.TraceEventType -> unit

Public Sub WriteEntry (message As String, severity As TraceEventType)

Parámetros

message: String

Required. Mensaje que se va a registrar. Si message es Nothing, se usa una cadena vacía.

severity: TraceEventType

El tipo de mensaje. De forma predeterminada, TraceEventType.Information.

Excepciones

InvalidEnumArgumentException

El tipo de mensaje no es uno de los TraceEventType valores de enumeración.

SecurityException

El código con confianza parcial llama al método , pero escribe en un agente de escucha de registro de eventos que requiere plena confianza.

Ejemplos

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Este ejemplo de código solo se puede ejecutar dentro de una aplicación cliente. Cambie My.Application.Log.WriteEntry a My.Log.WriteEntry para aplicaciones web.

Comentarios

El WriteEntry método escribe un mensaje en los agentes de escucha del registro de eventos de la aplicación.

En las aplicaciones cliente, el Log objeto está disponible a través del My.Application.Log objeto . En las aplicaciones web, el Log objeto está disponible a través del My.Log objeto .

En el caso de las sobrecargas que no toman el id argumento , el id objeto escrito en el registro se define en la tabla siguiente.

`severity`	Predeterminado `id`
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el WriteEntry método .

En	Vea
Escribir información de eventos en los agentes de escucha de registro de la aplicación	Cómo: Escribir mensajes de registro
Determinar dónde `Log` escribe información	Tutorial: Determinar el lugar en el que My.Application.Log escribe la información

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación Windows	Yes
Biblioteca de clases	Yes
Aplicación de consola	Yes
Biblioteca de controles de Windows	Yes
Biblioteca de controles web	No
Servicio de Windows	Yes
Sitio web	Yes

Consulte también

Se aplica a

WriteEntry(String, TraceEventType, Int32)

Escribe un mensaje en los agentes de escucha de registro de la aplicación.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity, int id);

public void WriteEntry(string message, System.Diagnostics.TraceEventType severity, int id);

member this.WriteEntry : string * System.Diagnostics.TraceEventType * int -> unit

Public Sub WriteEntry (message As String, severity As TraceEventType, id As Integer)

Parámetros

message: String

Required. Mensaje que se va a registrar. Si message es Nothing, se usa una cadena vacía.

severity: TraceEventType

El tipo de mensaje. De forma predeterminada, TraceEventType.Information.

id: Int32

Identificador de mensaje, que normalmente se usa para la correlación. De forma predeterminada, relacionada con entryType como se describe en la tabla.

Excepciones

InvalidEnumArgumentException

El tipo de mensaje no es uno de los TraceEventType valores de enumeración.

SecurityException

El código con confianza parcial llama al método , pero escribe en un agente de escucha de registro de eventos que requiere plena confianza.

Ejemplos

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Este ejemplo de código solo se puede ejecutar dentro de una aplicación cliente. Cambie My.Application.Log.WriteEntry a My.Log.WriteEntry para aplicaciones web.

Comentarios

El WriteEntry método escribe un mensaje en los agentes de escucha del registro de eventos de la aplicación.

En las aplicaciones cliente, el Log objeto está disponible a través del My.Application.Log objeto . En las aplicaciones web, el Log objeto está disponible a través del My.Log objeto .

En el caso de las sobrecargas que no toman el id argumento , el id objeto escrito en el registro se define en la tabla siguiente.

`severity`	Predeterminado `id`
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el WriteEntry método .

En	Vea
Escribir información de eventos en los agentes de escucha de registro de la aplicación	Cómo: Escribir mensajes de registro
Determinar dónde `Log` escribe información	Tutorial: Determinar el lugar en el que My.Application.Log escribe la información

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación Windows	Yes
Biblioteca de clases	Yes
Aplicación de consola	Yes
Biblioteca de controles de Windows	Yes
Biblioteca de controles web	No
Servicio de Windows	Yes
Sitio web	Yes

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?