WriteEntry Método (String, EventLogEntryType, Int32, Int16)
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método EventLog.WriteEntry (String, EventLogEntryType, Int32, Int16)

 

Grava uma entrada com o texto da mensagem determinada, identificador de evento definido pelo aplicativo e categoria definida pelo aplicativo para o log de eventos.

Namespace:   System.Diagnostics
Assembly:  System (em System.dll)

public void WriteEntry(
	string message,
	EventLogEntryType type,
	int eventID,
	short category
)

Parâmetros

message

A cadeia de caracteres para gravar no log de eventos.

type

Um dos valores de EventLogEntryType.

eventID

O identificador específico do aplicativo para o evento.

category

A subcategoria específico do aplicativo associada à mensagem.

Exception Condition
ArgumentException

O Source propriedade o EventLog não foi definido.

-ou-

O método tentou registrar uma nova fonte de evento, mas o nome do computador em MachineName não é válido.

-ou-

A origem já está registrada para um log de eventos diferente.

-ou-

eventID é menor que zero ou maior que UInt16.MaxValue.

-ou-

A cadeia de caracteres da mensagem é maior do que 31,839 bytes (bytes 32.766 em sistemas operacionais antes do Windows Vista).

-ou-

O nome da fonte resulta em um caminho de chave do registro mais de 254 caracteres.

InvalidOperationException

Não foi possível abrir a chave do registro para o log de eventos.

InvalidEnumArgumentException

type não é um EventLogEntryType válido.

Win32Exception

O sistema operacional relatou um erro ao gravar a entrada de evento no log de eventos.Um código de erro do Windows não está disponível.

Use esse método para gravar uma entrada com um aplicativo definido category o log de eventos.O Visualizador de eventos usa a categoria para filtrar eventos escritos por uma fonte de evento.O Visualizador de eventos pode exibir a categoria como um valor numérico, ou pode usar a categoria como um identificador de recurso para exibir uma cadeia de caracteres da categoria localizada.

System_CAPS_noteObservação

O category parâmetro deve ser um valor positivo.Valores negativos de categoria aparecem como um número positivo complementar de eventos Visualizador.Por exemplo, um – 10 aparece como 65,526, 1 como 65.535.

System_CAPS_noteObservação

O message cadeia de caracteres não pode conter %n, onde n é um valor inteiro (por exemplo, %1) porque o Visualizador de eventos tratá-la como uma cadeia de caracteres de inserção.Como um protocolo de Internet versão 6 endereços IPv6 podem conter essa seqüência de caracteres, você não pode registrar uma mensagem de evento que contém um endereço IPv6.

Para exibir cadeias de caracteres da categoria localizada no Visualizador de eventos, você deve usar uma fonte de evento configurado com um arquivo de recurso de categoria e defina o category para um identificador de recurso no arquivo de recurso de categoria.Se a origem do evento não tiver um arquivo de recurso da categoria configurado ou especificado category não indexar uma cadeia de caracteres no arquivo de recurso de categoria, o Visualizador de eventos exibirá o valor numérico de categoria para a entrada.Configurar o arquivo de recurso da categoria, juntamente com o número de cadeias de caracteres de categoria no arquivo de recurso, usando o EventLogInstaller ou o EventSourceCreationData classe.

Além da categoria, você pode especificar um identificador de evento para o evento que está sendo gravado no log de eventos.Identificadores de eventos, juntamente com a origem do evento, identificam exclusivamente um evento.Cada aplicativo pode definir seus próprios eventos numerados e as cadeias de caracteres de descrição para o qual eles são mapeados.Os visualizadores de eventos exibem esses valores de cadeia de caracteres para ajudar o usuário a entender o que deu errado e sugerir ações a serem tomadas.

Finalmente, você pode especificar um EventLogEntryType para o evento que está sendo gravado no log de eventos.O type é indicado por um ícone e texto na coluna de tipo no Visualizador de eventos para um log.Este parâmetro indica se o tipo de evento é erro, aviso, informações, auditoria com êxito ou auditoria sem êxito.

Você deve definir o Source propriedade em seu EventLog componente antes de poder criar entradas no log.Você deve criar e configurar a origem do evento antes de gravar a primeira entrada com a fonte.

Crie a nova fonte de evento durante a instalação do seu aplicativo.Isso dá tempo para o sistema operacional atualizar sua lista de origens de eventos registrados e suas configurações.Se o sistema operacional não tenha atualizado sua lista de origens de eventos, e você tentar gravar um evento com a nova fonte, que haverá falha na operação de gravação.Você pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método.Você deve ter direitos administrativos no computador para criar uma nova fonte de evento.

Se a fonte especificada na Source propriedade isso EventLog instância não está registrada no computador que o componente está gravando, WriteEntry chamadas CreateEventSource e registra o código-fonte.

System_CAPS_noteObservação

Se você não especificar um MachineName para a EventLog instância antes de chamar CreateEventSource ou WriteEntry, o computador local (".") é assumido.

Se o sistema precisa registrar o Source por meio de uma chamada para WriteEntry e o Log propriedade não foi definida no seu EventLog instância, o log padrão é o log do aplicativo.

System_CAPS_noteObservação

Muitas exceções listadas acima são geradas por erros gerados durante o processo de registro de Source.

A origem deve ser configurada para gravar entradas localizadas ou para gravação de cadeias de caracteres diretas.O WriteEntry método grava a cadeia de caracteres determinada diretamente para o log de eventos; ele não usa um arquivo de recursos de mensagem localizável.Use o WriteEvent método para gravar eventos usando um arquivo de recursos de mensagem localizada.

Se seu aplicativo grava entradas usando identificadores de recurso e os valores de cadeia de caracteres, você deve registrar duas fontes separadas.Por exemplo, configurar uma fonte com arquivos de recurso e, em seguida, usar essa fonte no WriteEvent método para gravar entradas usando identificadores de recurso para o log de eventos.Em seguida, criar uma fonte diferente sem arquivos de recurso e usam essa fonte no WriteEntry método gravar cadeias de caracteres diretamente no log de eventos usando essa fonte.

System_CAPS_noteObservação

Se você gravar uma entrada em um computador remoto, o valor da mensagem (a cadeia de caracteres de texto) não pode ser o esperado se o computador remoto não está em execução do .NET Framework.

System_CAPS_noteObservação

Se o message parâmetro contém um caractere NUL, a mensagem no log de eventos é encerrada pelo caractere NUL.

// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "ThirdSource";

// Write an informational entry to the event log.    
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);

EventLogPermission

for writing the event log information on the computer.Associated enumeration: EventLogPermissionAccess.Write

.NET Framework
Disponível desde 1.1
Retornar ao topo
Mostrar:
© 2016 Microsoft