EventLog.WriteEntry Método

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Parâmetros

Exceções

Exemplos

//Create a byte array for binary data to associate with the entry.
byte[] myByte = new byte[10];
//Populate the byte array with simulated data.
for (int i = 0; i < 10; i++)
{
    myByte[i] = (byte)(i % 2);
}
// Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ");
EventLog.WriteEntry("SecondSource", "Writing warning to event log.",
                     EventLogEntryType.Error, myEventID, myCategory, myByte);

' Create a byte array for binary data to associate with the entry.
Dim myByte(9) As Byte
Dim i As Integer
' Populate the byte array with simulated data.
For i = 0 To 9
    myByte(i) = CByte(i Mod 2)
Next i
' Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ")
EventLog.WriteEntry("SecondSource", "Writing warning to event log.", _
                     EventLogEntryType.Error, myEventID, myCategory, myByte)

Observações

Use este método para escrever dados específicos de eventos definidos pela aplicação no registo de eventos, usando uma fonte já registada como fonte de eventos para o registo apropriado. O Visualizador de Eventos não interpreta estes dados; apresenta dados brutos apenas num formato combinado hexadecimal e texto. Use dados específicos de eventos com moderação; Inclua-a apenas se tiver a certeza de que será útil. Também pode usar dados específicos de eventos para armazenar informação que a aplicação pode processar independentemente do Visualizador de Eventos. Por exemplo, pode escrever um visualizador especificamente para os seus eventos, ou escrever um programa que analise o ficheiro de registo e crie relatórios que incluam informações dos dados específicos do evento.

Para além dos dados binários, pode especificar uma categoria definida pela aplicação e um identificador de evento definido pela aplicação. O Visualizador de Eventos utiliza a categoria para filtrar eventos escritos por uma fonte de eventos. O Visualizador de Eventos pode mostrar a categoria como um valor numérico, ou pode usar a categoria como identificador de recurso para mostrar uma cadeia de categoria localizada.

Para exibir as cadeias de categoria localizadas no Visualizador de Eventos, deve usar uma fonte de evento configurada com um ficheiro de recurso de categoria e definir o category como identificador de recurso no ficheiro de recurso da categoria. Se a fonte do evento não tiver um ficheiro de recurso de categoria configurado, ou se o category especificado não indexar uma cadeia no ficheiro de recurso da categoria, então o Visualizador de Eventos apresenta o valor numérico da categoria para essa entrada. Configure o ficheiro de recurso da categoria, juntamente com o número de strings de categoria no ficheiro de recurso, usando a EventLogInstaller ou a EventSourceCreationData classe.

Os identificadores de eventos, juntamente com a fonte do evento, identificam de forma única um evento. Cada aplicação pode definir os seus próprios eventos numerados e as cadeias de descrição para as quais correspondem. Os visualizadores de eventos exibem estes valores de cadeia para ajudar o utilizador a perceber o que correu mal e sugerir que ações tomar.

Finalmente, pode especificar um EventLogEntryType para o evento que está a ser escrito no registo de eventos. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo. Este parâmetro indica se o tipo de evento é erro, aviso, informação, auditoria de sucesso ou auditoria de falha.

Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte. Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Parâmetros

Exceções

Exemplos

int myEventID = 20;
short myCategory = 10;
// Write an informational entry to the event log.
Console.WriteLine("Write from first source ");
EventLog.WriteEntry("FirstSource", "Writing warning to event log.",
                     EventLogEntryType.Information, myEventID, myCategory);

Dim myEventID As Integer = 10
Dim myCategory As Short = 20
' Write an informational entry to the event log.
Console.WriteLine("Write from first source ")
EventLog.WriteEntry("FirstSource", "Writing warning to event log.", _
                           EventLogEntryType.Information, myEventID, myCategory)

Observações

Use este método para escrever uma entrada com uma aplicação definida category no registo de eventos, usando uma fonte que já esteja registada como fonte de eventos para o registo apropriado. O Visualizador de Eventos utiliza a categoria para filtrar eventos escritos por uma fonte de eventos. O Visualizador de Eventos pode mostrar a categoria como um valor numérico, ou pode usar a categoria como identificador de recurso para mostrar uma cadeia de categoria localizada.

Para exibir as cadeias de categoria localizadas no Visualizador de Eventos, deve usar uma fonte de evento configurada com um ficheiro de recurso de categoria e definir o category como identificador de recurso no ficheiro de recurso da categoria. Se a fonte do evento não tiver um ficheiro de recurso de categoria configurado, ou se o category especificado não indexar uma cadeia no ficheiro de recurso da categoria, então o Visualizador de Eventos apresenta o valor numérico da categoria para essa entrada. Configure o ficheiro de recurso da categoria, juntamente com o número de strings de categoria no ficheiro de recurso, usando a EventLogInstaller ou a EventSourceCreationData classe.

Para além da categoria, pode especificar um identificador de evento para o evento que está a ser escrito no registo de eventos. Os identificadores de eventos, juntamente com a fonte do evento, identificam de forma única um evento. Cada aplicação pode definir os seus próprios eventos numerados e as cadeias de descrição para as quais correspondem. Os visualizadores de eventos exibem estes valores de cadeia para ajudar o utilizador a perceber o que correu mal e sugerir que ações tomar.

Finalmente, pode especificar um EventLogEntryType para o evento que está a ser escrito no registo de eventos. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo. Este parâmetro indica se o tipo de evento é erro, aviso, informação, auditoria de sucesso ou auditoria de falha.

Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte. Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Parâmetros

Exceções

Exemplos

// Create the source, if it does not already exist.
string myLogName = "myNewLog";
if(!EventLog.SourceExists("MySource"))
{
   // An event log source should not be created and immediately used.
   // There is a latency time to enable the source, it should be created
   // prior to executing the application that uses the source.
   // Execute this sample a second time to use the new source.
   EventLog.CreateEventSource("MySource", myLogName);
   Console.WriteLine("Created EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   return;
}
else
   {
       myLogName = EventLog.LogNameFromSourceName("MySource",".");
   }
   // Create an EventLog and assign source.
   EventLog myEventLog = new EventLog();
myEventLog.Source = "MySource";
myEventLog.Log = myLogName;

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicatinEventId = 1100;
short myApplicatinCategoryId = 1;

// Set the 'data' for the event.
byte[] myRawData = new byte[4];
for(int i=0;i<4;i++)
{
   myRawData[i]=1;
}
// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
myEventLog.WriteEntry(myMessage,myEventLogEntryType,
   myApplicatinEventId, myApplicatinCategoryId, myRawData);

' Create the source, if it does not already exist.
dim myLogName as string = "myNewLog"
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", myLogName)
   Console.WriteLine("Creating EventSource")
else
   myLogName = EventLog.LogNameFromSourceName("MySource",".")
End If

' Create an EventLog and assign source.
Dim myEventLog As New EventLog()
myEventLog.Source = "MySource"
myEventLog.Log = myLogName

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicatinEventId As Integer = 1100
Dim myApplicatinCategoryId As Short = 1

' Set the 'data' for the event.
Dim myRawData(3) As Byte
Dim i As Integer
For i = 0 To 3
   myRawData(i) = 1
Next i
' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
myEventLog.WriteEntry(myMessage, myEventLogEntryType, myApplicatinEventId, _
                     myApplicatinCategoryId, myRawData)

Observações

Use esta sobrecarga para escrever dados específicos de eventos definidos pela aplicação no registo de eventos. O Visualizador de Eventos não interpreta estes dados; apresenta dados brutos apenas num formato combinado hexadecimal e texto. Use dados específicos de eventos com moderação, incluindo-os apenas se tiver a certeza de que serão úteis a alguém que esteja a depurar o problema. Também pode usar dados específicos de eventos para armazenar informação que a aplicação pode processar independentemente do Visualizador de Eventos. Por exemplo, pode escrever um visualizador especificamente para os seus eventos, ou escrever um programa que analise o ficheiro de registo e crie relatórios que incluam informações dos dados específicos do evento.

Para além dos dados binários, pode especificar uma categoria definida pela aplicação e um identificador de evento definido pela aplicação. O Visualizador de Eventos utiliza a categoria para filtrar eventos escritos por uma fonte de eventos. O Visualizador de Eventos pode mostrar a categoria como um valor numérico, ou pode usar a categoria como identificador de recurso para mostrar uma cadeia de categoria localizada.

Para exibir as cadeias de categoria localizadas no Visualizador de Eventos, deve usar uma fonte de evento configurada com um ficheiro de recurso de categoria e definir o category como identificador de recurso no ficheiro de recurso da categoria. Se a fonte do evento não tiver um ficheiro de recurso de categoria configurado, ou se o category especificado não indexar uma cadeia no ficheiro de recurso da categoria, então o Visualizador de Eventos apresenta o valor numérico da categoria para essa entrada. Configure o ficheiro de recurso da categoria, juntamente com o número de strings de categoria no ficheiro de recurso, usando a EventLogInstaller ou a EventSourceCreationData classe.

Os identificadores de eventos, juntamente com a fonte do evento, identificam de forma única um evento. Cada aplicação pode definir os seus próprios eventos numerados e as cadeias de descrição para as quais correspondem. Os visualizadores de eventos exibem estes valores de cadeia para ajudar o utilizador a perceber o que correu mal e sugerir que ações tomar.

Finalmente, pode especificar um EventLogEntryType para o evento que está a ser escrito no registo de eventos. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo. Este parâmetro indica se o tipo de evento é erro, aviso, informação, auditoria de sucesso ou auditoria de falha.

Deve definir a Source propriedade no seu EventLog componente antes de poder escrever entradas no log. Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte.

Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

Se a fonte especificada na Source propriedade desta EventLog instância não estiver registada no computador onde o seu componente está a escrever, WriteEntry chama CreateEventSource e regista a fonte.

Se o sistema precisar de registar o Source através de uma chamada e WriteEntry a Log propriedade não tiver sido definida na sua EventLog instância, o registo passa por defeito ao registo de aplicação.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer)

Parâmetros

Exceções

Exemplos

// Create the source, if it does not already exist.
if(!EventLog.SourceExists("MySource"))
{
   // An event log source should not be created and immediately used.
   // There is a latency time to enable the source, it should be created
   // prior to executing the application that uses the source.
   // Execute this sample a second time to use the new source.
   EventLog.CreateEventSource("MySource", "myNewLog");
   Console.WriteLine("Creating EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   // The source is created.  Exit the application to allow it to be registered.
   return;
}

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicationEventId = 100;

// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
EventLog.WriteEntry("MySource",myMessage,
   myEventLogEntryType, myApplicationEventId);

' Create the source, if it does not already exist.
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", "myNewLog")
   Console.WriteLine("Creating EventSource")
End If

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicationEventId As Integer = 100

' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
EventLog.WriteEntry("MySource", myMessage, myEventLogEntryType, myApplicationEventId)

Observações

Use este método para escrever uma entrada com uma aplicação definida eventID no registo de eventos, usando uma fonte já registada como fonte de eventos para o registo apropriado. O eventID, juntamente com a fonte, identificam de forma única um evento. Cada aplicação pode definir os seus próprios eventos numerados e as cadeias de descrição para as quais correspondem. Os visualizadores de eventos apresentam estas cadeias ao utilizador para o ajudar a perceber o que correu mal e sugerir que ações tomar.

Além do identificador de evento, esta sobrecarga de WriteEntry permite especificar um EventLogEntryType para o evento que está a ser escrito no registo de eventos. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo. Este parâmetro indica se o tipo de evento é erro, aviso, informação, auditoria de sucesso ou auditoria de falha.

Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte. Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

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

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Parâmetros

Exceções

Exemplos

// 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);

' Create an EventLog instance and assign its source.
Dim myLog As 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)

Observações

Use este método para escrever uma entrada com uma aplicação definida category no registo de eventos. O Visualizador de Eventos utiliza a categoria para filtrar eventos escritos por uma fonte de eventos. O Visualizador de Eventos pode mostrar a categoria como um valor numérico, ou pode usar a categoria como identificador de recurso para mostrar uma cadeia de categoria localizada.

Para exibir as cadeias de categoria localizadas no Visualizador de Eventos, deve usar uma fonte de evento configurada com um ficheiro de recurso de categoria e definir o category como identificador de recurso no ficheiro de recurso da categoria. Se a fonte do evento não tiver um ficheiro de recurso de categoria configurado, ou se o category especificado não indexar uma cadeia no ficheiro de recurso da categoria, então o Visualizador de Eventos apresenta o valor numérico da categoria para essa entrada. Configure o ficheiro de recurso da categoria, juntamente com o número de strings de categoria no ficheiro de recurso, usando a EventLogInstaller ou a EventSourceCreationData classe.

Para além da categoria, pode especificar um identificador de evento para o evento que está a ser escrito no registo de eventos. Os identificadores de eventos, juntamente com a fonte do evento, identificam de forma única um evento. Cada aplicação pode definir os seus próprios eventos numerados e as cadeias de descrição para as quais correspondem. Os visualizadores de eventos exibem estes valores de cadeia para ajudar o utilizador a perceber o que correu mal e sugerir que ações tomar.

Finalmente, pode especificar um EventLogEntryType para o evento que está a ser escrito no registo de eventos. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo. Este parâmetro indica se o tipo de evento é erro, aviso, informação, auditoria de sucesso ou auditoria de falha.

Deve definir a Source propriedade no seu EventLog componente antes de poder escrever entradas no log. Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte.

Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

Se a fonte especificada na Source propriedade desta EventLog instância não estiver registada no computador onde o seu componente está a escrever, WriteEntry chama CreateEventSource e regista a fonte.

Se o sistema precisar de registar o Source através de uma chamada e WriteEntry a Log propriedade não tiver sido definida na sua EventLog instância, o registo passa por defeito ao registo de aplicação.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type);

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

Public Sub WriteEntry (message As String, type As EventLogEntryType)

Parâmetros

Exceções

Exemplos

O exemplo seguinte escreve uma entrada de aviso num registo de eventos, "MyNewLog", no computador local.

using System;
using System.Diagnostics;
using System.Threading;

class MySample1
{

    public static void Main()
    {

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

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning);
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog("MyNewLog")
        myLog.Source = "MyNewLogSource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning)
    End Sub
End Class

Observações

Use este método para escrever uma entrada de a especificado EventLogEntryType no registo de eventos. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo.

Deve definir a Source propriedade no seu EventLog componente antes de poder escrever entradas no log. Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte.

Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

Se a fonte especificada na Source propriedade desta EventLog instância não estiver registada no computador onde o seu componente está a escrever, WriteEntry chama CreateEventSource e regista a fonte.

Se o sistema precisar de registar o Source através de uma chamada e WriteEntry a Log propriedade não tiver sido definida na sua EventLog instância, o registo passa por defeito ao registo de aplicação.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID);

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

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer)

Parâmetros

Exceções

Exemplos

// 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);

' Create an EventLog instance and assign its source.
Dim myLog As 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)

Observações

Use este método para escrever uma entrada com uma aplicação definida eventID no registo de eventos. Juntamente eventID com a fonte, identificam de forma única um evento. Cada aplicação pode definir os seus próprios eventos numerados e as cadeias de descrição para as quais correspondem. Os visualizadores de eventos exibem estes valores de cadeia para ajudar o utilizador a perceber o que correu mal e sugerir que ações tomar.

Além do identificador de evento, pode especificar um EventLogEntryType para o evento que está a ser escrito no registo de eventos. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo. Este parâmetro indica se o tipo de evento é erro, aviso, informação, auditoria de sucesso ou auditoria de falha.

Deve definir a Source propriedade no seu EventLog componente antes de poder escrever entradas no log. Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte.

Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

Se a fonte especificada na Source propriedade desta EventLog instância não estiver registada no computador onde o seu componente está a escrever, WriteEntry chama CreateEventSource e regista a fonte.

Se o sistema precisar de registar o Source através de uma chamada e WriteEntry a Log propriedade não tiver sido definida na sua EventLog instância, o registo passa por defeito ao registo de aplicação.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 static void WriteEntry(System::String ^ source, System::String ^ message);

public static void WriteEntry(string source, string message);

static member WriteEntry : string * string -> unit

Public Shared Sub WriteEntry (source As String, message As String)

Parâmetros

Exceções

Exemplos

O exemplo seguinte cria a fonte MySource se esta ainda não existir, e escreve uma entrada no registo MyNewLogde eventos .

using System;
using System.Diagnostics;
using System.Threading;

class MySample
{

    public static void Main()
    {

        // Create the source, if it does not already exist.
        if (!EventLog.SourceExists("MySource"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "myNewLog");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource", "Writing to event log.");
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "myNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing to event log.")
    End Sub
End Class

Observações

Use este método para escrever uma entrada de informação no registo de eventos, usando uma fonte que já esteja registada como fonte de eventos para o registo apropriado. Se quiser especificar qualquer outro EventLogEntryType, use uma sobrecarga diferente de WriteEntry.

Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte. Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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

public void WriteEntry(string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parâmetros

Exceções

Exemplos

O exemplo seguinte cria a fonte MySource se esta ainda não existir, e escreve uma entrada no registo MyNewLogde eventos .

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

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

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Observações

Use este método para escrever uma entrada de informação no registo de eventos associado a esta EventLog instância. Se quiser especificar qualquer outro EventLogEntryType, use uma sobrecarga diferente de WriteEntry.

Deve definir a Source propriedade no seu EventLog componente antes de poder escrever entradas no log. Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte.

Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

Se a fonte especificada na Source propriedade desta EventLog instância não estiver registada no computador onde o seu componente está a escrever, WriteEntry chama CreateEventSource e regista a fonte.

Se o sistema precisar de registar o Source através de uma chamada e WriteEntry a Log propriedade não tiver sido definida na sua EventLog instância, o registo passa por defeito ao registo de aplicação.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType)

Parâmetros

Exceções

Exemplos

O exemplo seguinte escreve uma entrada de aviso num registo de eventos, "MyNewLog", no computador local.

using System;
using System.Diagnostics;
using System.Threading;

class MySample2
{

    public static void Main()
    {

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource",
            "Writing warning to event log.",
            EventLogEntryType.Warning);
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing warning to event log.", _
            EventLogEntryType.Warning)
    End Sub
End Class

Observações

Use este método para escrever uma entrada de a especificado EventLogEntryType no registo de eventos, usando uma fonte já registada como fonte de eventos para o registo apropriado. O type é indicado por um ícone e texto na coluna Tipo na Visualizador de Eventos para um registo.

Deve criar e configurar a fonte do evento antes de escrever a primeira entrada com a fonte. Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller, ou usando o CreateEventSource método. Deve ter direitos administrativos no computador para criar uma nova fonte de eventos.

A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. O WriteEntry método escreve a cadeia dada diretamente no registo de eventos; não utiliza um ficheiro de recurso de mensagem localizável. Use o WriteEvent método para escrever eventos usando um ficheiro de recurso de mensagem localizado.

Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ver também

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries