Log.WriteEntry Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic.Logging

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Escreve uma mensagem para os ouvintes de registo da aplicação.

Sobrecargas

Name	Description
WriteEntry(String)	Escreve uma mensagem para os ouvintes de registo da aplicação.
WriteEntry(String, TraceEventType)	Escreve uma mensagem para os ouvintes de registo da aplicação.
WriteEntry(String, TraceEventType, Int32)	Escreve uma mensagem para os ouvintes de registo da aplicação.

WriteEntry(String)

Escreve uma mensagem para os ouvintes de registo da aplicação.

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 para registar. Se message for Nothing, usa-se uma cadeia vazia.

Exceções

SecurityException

Código com confiança parcial chama o método, mas escreve num ouvinte de registo de eventos que requer total confiança.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteEntry método para registar informações de rastreamento. Para mais informações, veja Como: Escrever Mensagens de Registo.

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 dentro de uma aplicação cliente. Mudar My.Application.Log.WriteEntry para My.Log.WriteEntry aplicações Web.

Observações

O WriteEntry método escreve uma mensagem para os ouvintes do registo de eventos da aplicação.

Em aplicações cliente, o Log objeto está disponível através do My.Application.Log objeto. Em aplicações Web, o Log objeto está disponível através do My.Log objeto.

Para saber quais os ouvintes de log que recebem as WriteEntry mensagens do método, veja Walkthrough: Determinando Onde o My.Application.Log Escreve Informação. Podes mudar os ouvintes de registo por defeito. Para mais informações, consulte Trabalhar com Registos de Aplicação.

Para sobrecargas que não aceitam o id argumento, o id escrito no log é definido pela tabela seguinte.

`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 seguinte lista exemplos de tarefas que envolvem o WriteEntry método.

Para	Veja
Escreva informação de eventos nos ouvintes de registo da aplicação	Como escrever mensagens de log
Determinar onde `Log` escreve informação	Passo a passo: Determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de Projeto	Available
Aplicação do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo de console	Sim
Biblioteca de Controlo do Windows	Sim
Biblioteca de controle da Web	No
Serviço Windows	Sim
Web site	Sim

Ver também

Aplica-se a

WriteEntry(String, TraceEventType)

Escreve uma mensagem para os ouvintes de registo da aplicação.

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 para registar. Se message for Nothing, usa-se uma cadeia vazia.

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

Código com confiança parcial chama o método, mas escreve num ouvinte de registo de eventos que requer total confiança.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteEntry método para registar informações de rastreamento. Para mais informações, veja Como: Escrever Mensagens de Registo.

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 dentro de uma aplicação cliente. Mudar My.Application.Log.WriteEntry para My.Log.WriteEntry aplicações Web.

Observações

O WriteEntry método escreve uma mensagem para os ouvintes do registo de eventos da aplicação.

Em aplicações cliente, o Log objeto está disponível através do My.Application.Log objeto. Em aplicações Web, o Log objeto está disponível através do My.Log objeto.

Para sobrecargas que não aceitam o id argumento, o id escrito no log é definido pela tabela seguinte.

`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 seguinte lista exemplos de tarefas que envolvem o WriteEntry método.

Para	Veja
Escreva informação de eventos nos ouvintes de registo da aplicação	Como escrever mensagens de log
Determinar onde `Log` escreve informação	Passo a passo: Determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de Projeto	Available
Aplicação do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo de console	Sim
Biblioteca de Controlo do Windows	Sim
Biblioteca de controle da Web	No
Serviço Windows	Sim
Web site	Sim

Ver também

Aplica-se a

WriteEntry(String, TraceEventType, Int32)

Escreve uma mensagem para os ouvintes de registo da aplicação.

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 para registar. Se message for Nothing, usa-se uma cadeia vazia.

severity: TraceEventType

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

id: Int32

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

Exceções

InvalidEnumArgumentException

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

SecurityException

Código com confiança parcial chama o método, mas escreve num ouvinte de registo de eventos que requer total confiança.

Exemplos

Este exemplo mostra como usar o My.Application.Log.WriteEntry método para registar informações de rastreamento. Para mais informações, veja Como: Escrever Mensagens de Registo.

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 dentro de uma aplicação cliente. Mudar My.Application.Log.WriteEntry para My.Log.WriteEntry aplicações Web.

Observações

O WriteEntry método escreve uma mensagem para os ouvintes do registo de eventos da aplicação.

Em aplicações cliente, o Log objeto está disponível através do My.Application.Log objeto. Em aplicações Web, o Log objeto está disponível através do My.Log objeto.

Para sobrecargas que não aceitam o id argumento, o id escrito no log é definido pela tabela seguinte.

`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 seguinte lista exemplos de tarefas que envolvem o WriteEntry método.

Para	Veja
Escreva informação de eventos nos ouvintes de registo da aplicação	Como escrever mensagens de log
Determinar onde `Log` escreve informação	Passo a passo: Determinando onde My.Application.Log grava informações

Disponibilidade por tipo de projeto

Tipo de Projeto	Available
Aplicação do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo de console	Sim
Biblioteca de Controlo do Windows	Sim
Biblioteca de controle da Web	No
Serviço Windows	Sim
Web site	Sim

Ver também

Aplica-se a

Comentários

Esta página foi útil?