Método WriteEntry (My.Application.Log e My.Log)
Grava uma mensagem aos ouvintes do log do aplicativo.
' Usage
My.Application.Log.WriteEntry(message)
My.Application.Log.WriteEntry(message ,severity)
My.Application.Log.WriteEntry(message ,severity ,id)
' Web usage
My.Log.WriteEntry(message)
My.Log.WriteEntry(message ,severity)
My.Log.WriteEntry(message ,severity ,id)
' Declaration
Public Sub WriteEntry( _
ByVal message As String _
)
' -or-
Public Sub WriteEntry( _
ByVal message As String, _
ByVal severity As System.Diagnostics.TraceEventType _
)
' -or-
Public Sub WriteEntry( _
ByVal message As String, _
ByVal severity As System.Diagnostics.TraceEventType, _
ByVal id As Integer _
)
Parâmetros
message
Obrigatório.A mensagem para fazer logon.Se message for Nothing, uma sequência de caracteres vazia será usada.severity
O tipo de mensagem.Por padrão, TraceEventType.Information.id
Identificador de mensagem, normalmente usado para correlação.Por padrão, relacionado a entryType conforme descrito na tabela.
Exceções
As condições a seguir causam uma exceção:
O tipo de exceção ou mensagem é Nothing (ArgumentNullException).
O tipo de mensagem não é um dos valores de enumeração TraceEventType (InvalidEnumArgumentException).
Código com confiabilidade parcial chama o método, mas escreve em um ouvinte de evento que exige confiabilidade total (SecurityException).
Comentários
O método WriteEntry grava uma mensagem para o ouvinte de log de eventos do aplicativo.
Em aplicativos do cliente, o objeto Log está disponível através do objeto My.Application.Log.Em aplicativos do Web, o objeto Log está disponível através do objeto My.Log.
Para saber quais ouvintes de log recebem as mensagens do método WriteEntry, consulte Demonstra Passo a passo: Determinar onde My.Aplicativo.Log Writes informações.Você pode alterar ouvintes de log padrões.Para obter mais informações, consulte Trabalhando com logs de aplicativos em Visual Basic.
Para sobrecargas que não têm o argumento id, o id gravado no log é definido pela tabela a seguir.
severity |
id padrão |
|---|---|
0 |
|
1 |
|
2 |
|
3 |
|
4 |
|
5 |
|
6 |
|
7 |
|
8 |
|
9 |
Tarefas
A tabela a seguir lista exemplos de tarefas envolvendo o método WriteEntry.
Para |
Consulte |
|---|---|
Gravar informações de evento para ouvintes do log do aplicativo |
|
Determina onde Log grava as informações. |
Demonstra Passo a passo: Determinar onde My.Aplicativo.Log Writes informações |
Exemplo
Este exemplo mostra como usar o método My.Application.Log.WriteEntry para registrar informações de rastreamento.Para obter mais informações, consulte Como: Mensagens de log Gravar.
Public Sub TracingTest(ByVal fileName As String)
My.Application.Log.WriteEntry( _
"Entering TracingTest with argument " & _
fileName & ".")
' Code to trace goes here.
My.Application.Log.WriteEntry( _
"Exiting TracingTest with argument " & _
fileName & ".")
End Sub
Esta exemplo de código pode executar somente em um aplicativo cliente.Altere My.Application.Log.WriteEntry para My.Log.WriteEntry para aplicativos da Web.
Requisitos
Namespace:Microsoft.VisualBasic.Logging
Classe:Log
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)
Disponibilidade por Tipo de Projeto
Tipo de Projeto |
Disponível |
|---|---|
Aplicativo do Windows |
Sim |
Biblioteca de Classe |
Sim |
Aplicativo de Console |
Sim |
Biblioteca de Controle do Windows |
Sim |
Biblioteca de Controle da Web |
Não |
Serviço do Windows |
Sim |
Site |
Sim |
Permissões
A permissão a seguir pode ser necessária:
Permissão |
Descrição |
|---|---|
Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted. |
Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.
Consulte também
Tarefas
Demonstra Passo a passo: Determinar onde My.Aplicativo.Log Writes informações
Conceitos
Trabalhando com logs de aplicativos em Visual Basic