Log.WriteEntry Método

Definição

Namespace:
Microsoft.VisualBasic.Logging
Assembly:
Microsoft.VisualBasic.dll

Grava uma mensagem nos ouvintes de log do aplicativo.

Sobrecargas

Nome Description
WriteEntry(String)

Grava uma mensagem nos ouvintes de log do aplicativo.
WriteEntry(String, TraceEventType)

Grava uma mensagem nos ouvintes de log do aplicativo.
WriteEntry(String, TraceEventType, Int32)

Grava uma mensagem nos ouvintes de log do aplicativo.

WriteEntry(String)

Grava uma mensagem nos ouvintes de log do aplicativo.

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. A mensagem a ser registrada em log. Se message for Nothing, uma cadeia de caracteres vazia será usada.

Exceções

SecurityException

O código com confiança parcial chama o método, mas grava em um ouvinte de log de eventos que requer confiança total.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteEntry método para registrar informações de rastreamento em log. Para obter mais informações, consulte Como gravar mensagens de log.

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 exemplo de código só pode ser executado em um aplicativo cliente. Alterar My.Application.Log.WriteEntry para My.Log.WriteEntry aplicativos Web.

Comentários

O WriteEntry método grava uma mensagem nos ouvintes de log de eventos do aplicativo.

Em aplicativos cliente, o Log objeto está disponível por meio do My.Application.Log objeto. Em aplicativos Web, o Log objeto está disponível por meio do My.Log objeto.

Para saber quais ouvintes de log recebem as WriteEntry mensagens do método, consulte Passo a passo: Determinando onde My.Application.Log grava informações. Você pode alterar os ouvintes de log padrão. Para obter mais informações, consulte Como trabalhar com logs de aplicativos.

Para sobrecargas que não levam o id argumento, a gravação id no log é definida pela tabela a seguir.

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

A tabela a seguir lista exemplos de tarefas que envolvem o WriteEntry método.

Para Veja
Gravar informações de evento para os ouvintes de log do aplicativo Como gravar mensagens de log
Determinar onde Log as informações de gravação Passo a passo: determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto Available
Aplicativo do Windows Yes
Biblioteca de Classes Yes
Aplicativo de console Yes
Biblioteca de Controle do Windows Yes
Biblioteca de Controles da Web Não
Serviço do Windows Yes
Site da web Yes

Confira também

Aplica-se a

WriteEntry(String, TraceEventType)

Grava uma mensagem nos ouvintes de log do aplicativo.

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. A mensagem a ser registrada em log. Se message for Nothing, uma cadeia de caracteres vazia será usada.

severity
TraceEventType

O tipo de mensagem. Por padrão, TraceEventType.Information.

Exceções

InvalidEnumArgumentException

O tipo de mensagem não é um dos valores de TraceEventType enumeração.

SecurityException

O código com confiança parcial chama o método, mas grava em um ouvinte de log de eventos que requer confiança total.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteEntry método para registrar informações de rastreamento em log. Para obter mais informações, consulte Como gravar mensagens de log.

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 exemplo de código só pode ser executado em um aplicativo cliente. Alterar My.Application.Log.WriteEntry para My.Log.WriteEntry aplicativos Web.

Comentários

O WriteEntry método grava uma mensagem nos ouvintes de log de eventos do aplicativo.

Em aplicativos cliente, o Log objeto está disponível por meio do My.Application.Log objeto. Em aplicativos Web, o Log objeto está disponível por meio do My.Log objeto.

Para saber quais ouvintes de log recebem as WriteEntry mensagens do método, consulte Passo a passo: Determinando onde My.Application.Log grava informações. Você pode alterar os ouvintes de log padrão. Para obter mais informações, consulte Como trabalhar com logs de aplicativos.

Para sobrecargas que não levam o id argumento, a gravação id no log é definida pela tabela a seguir.

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

A tabela a seguir lista exemplos de tarefas que envolvem o WriteEntry método.

Para Veja
Gravar informações de evento para os ouvintes de log do aplicativo Como gravar mensagens de log
Determinar onde Log as informações de gravação Passo a passo: determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto Available
Aplicativo do Windows Yes
Biblioteca de Classes Yes
Aplicativo de console Yes
Biblioteca de Controle do Windows Yes
Biblioteca de Controles da Web Não
Serviço do Windows Yes
Site da web Yes

Confira também

Aplica-se a

WriteEntry(String, TraceEventType, Int32)

Grava uma mensagem nos ouvintes de log do aplicativo.

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. A mensagem a ser registrada em log. Se message for Nothing, uma cadeia de caracteres vazia será usada.

severity
TraceEventType

O tipo de mensagem. Por padrão, TraceEventType.Information.

id
Int32

Identificador de mensagem, normalmente usado para correlação. Por padrão, relacionado à entryType conforme descrito na tabela.

Exceções

InvalidEnumArgumentException

O tipo de mensagem não é um dos valores de TraceEventType enumeração.

SecurityException

O código com confiança parcial chama o método, mas grava em um ouvinte de log de eventos que requer confiança total.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteEntry método para registrar informações de rastreamento em log. Para obter mais informações, consulte Como gravar mensagens de log.

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 exemplo de código só pode ser executado em um aplicativo cliente. Alterar My.Application.Log.WriteEntry para My.Log.WriteEntry aplicativos Web.

Comentários

O WriteEntry método grava uma mensagem nos ouvintes de log de eventos do aplicativo.

Em aplicativos cliente, o Log objeto está disponível por meio do My.Application.Log objeto. Em aplicativos Web, o Log objeto está disponível por meio do My.Log objeto.

Para saber quais ouvintes de log recebem as WriteEntry mensagens do método, consulte Passo a passo: Determinando onde My.Application.Log grava informações. Você pode alterar os ouvintes de log padrão. Para obter mais informações, consulte Como trabalhar com logs de aplicativos.

Para sobrecargas que não levam o id argumento, a gravação id no log é definida pela tabela a seguir.

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

A tabela a seguir lista exemplos de tarefas que envolvem o WriteEntry método.

Para Veja
Gravar informações de evento para os ouvintes de log do aplicativo Como gravar mensagens de log
Determinar onde Log as informações de gravação Passo a passo: determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de projeto Available
Aplicativo do Windows Yes
Biblioteca de Classes Yes
Aplicativo de console Yes
Biblioteca de Controle do Windows Yes
Biblioteca de Controles da Web Não
Serviço do Windows Yes
Site da web Yes

Confira também

Aplica-se a