EventLog.WriteEntry EventLog.WriteEntry EventLog.WriteEntry EventLog.WriteEntry Method

Definizione

Scrive una voce nel registro eventi.Writes an entry in the event log.

Overload

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione, usando l'origine eventi registrata specificata, e allega dati binari al messaggio.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log (using the specified registered event source) and appends binary data to the message.

WriteEntry(String, String, EventLogEntryType, Int32, Int16) WriteEntry(String, String, EventLogEntryType, Int32, Int16) WriteEntry(String, String, EventLogEntryType, Int32, Int16) WriteEntry(String, String, EventLogEntryType, Int32, Int16)

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione, usando l'origine eventi registrata specificata.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log, using the specified registered event source. Il parametro category può essere usato dal Visualizzatore eventi per filtrare gli eventi nel registro.The category can be used by the Event Viewer to filter events in the log.

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione, e allega dati binari al messaggio.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log, and appends binary data to the message.

WriteEntry(String, String, EventLogEntryType, Int32) WriteEntry(String, String, EventLogEntryType, Int32) WriteEntry(String, String, EventLogEntryType, Int32) WriteEntry(String, String, EventLogEntryType, Int32)

Scrive nel registro eventi una voce con il testo del messaggio indicato e con un identificatore eventi definito dall'applicazione, usando l'origine eventi registrata specificata.Writes an entry with the given message text and application-defined event identifier to the event log, using the specified registered event source.

WriteEntry(String, EventLogEntryType, Int32, Int16) WriteEntry(String, EventLogEntryType, Int32, Int16) WriteEntry(String, EventLogEntryType, Int32, Int16) WriteEntry(String, EventLogEntryType, Int32, Int16)

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log.

WriteEntry(String, EventLogEntryType) WriteEntry(String, EventLogEntryType) WriteEntry(String, EventLogEntryType) WriteEntry(String, EventLogEntryType)

Scrive nel registro eventi una voce relativa a errori, avvisi, informazioni, controlli riusciti o non riusciti, insieme al testo di un determinato messaggio.Writes an error, warning, information, success audit, or failure audit entry with the given message text to the event log.

WriteEntry(String, EventLogEntryType, Int32) WriteEntry(String, EventLogEntryType, Int32) WriteEntry(String, EventLogEntryType, Int32) WriteEntry(String, EventLogEntryType, Int32)

Scrive nel registro eventi una voce con il testo del messaggio indicato e con un identificatore eventi definito dall'applicazione.Writes an entry with the given message text and application-defined event identifier to the event log.

WriteEntry(String, String) WriteEntry(String, String) WriteEntry(String, String) WriteEntry(String, String)

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi, usando l'origine eventi registrata specificata.Writes an information type entry with the given message text to the event log, using the specified registered event source.

WriteEntry(String) WriteEntry(String) WriteEntry(String) WriteEntry(String)

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi.Writes an information type entry, with the given message text, to the event log.

WriteEntry(String, String, EventLogEntryType) WriteEntry(String, String, EventLogEntryType) WriteEntry(String, String, EventLogEntryType) WriteEntry(String, String, EventLogEntryType)

Scrive nel registro eventi una voce relativa a errori, errori, avvisi, informazioni, controlli riusciti o controlli non riusciti, insieme al testo di un determinato messaggio, usando l'origine eventi registrata specificata.Writes an error, warning, information, success audit, or failure audit entry with the given message text to the event log, using the specified registered event source.

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione, usando l'origine eventi registrata specificata, e allega dati binari al messaggio.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log (using the specified registered event source) and appends binary data to the message.

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())

Parametri

source
String String String String

Origine con cui l'applicazione è registrata nel computer specificato.The source by which the application is registered on the specified computer.

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

eventID
Int32 Int32 Int32 Int32

Identificatore specifico dell'applicazione per l'evento.The application-specific identifier for the event.

category
Int16 Int16 Int16 Int16

Sottocategoria specifica per l'applicazione associata al messaggio.The application-specific subcategory associated with the message.

rawData
Byte[]

Matrice di byte contenente i dati binari associati alla voce.An array of bytes that holds the binary data associated with the entry.

Eccezioni

Il valore source è una stringa vuota ("").The source value is an empty string ("").

In alternativa-or- Il valore di source è null.The source value is null.

In alternativa-or- eventID è minore di zero o maggiore di MaxValue.eventID is less than zero or greater than MaxValue.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

//Create a byte array for binary data to associate with the entry.
array<Byte>^myByte = gcnew array<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.
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)

Commenti

Usare questo metodo per scrivere dati specifici degli eventi definiti dall'applicazione nel registro eventi, utilizzare un'origine già registrata come un'origine evento per il log appropriato.Use this method to write application-defined event-specific data to the event log, using a source already registered as an event source for the appropriate log. Il Visualizzatore eventi non interpreta i dati; Visualizza i dati non elaborati solo in un formato esadecimale e testo combinato.The Event Viewer does not interpret this data; it displays raw data only in a combined hexadecimal and text format. Usare i dati specifici degli eventi sporadicamente; incluso solo se si è certi che possa risultare utile.Use event-specific data sparingly; include it only if you are sure it will be useful. È anche possibile usare i dati specifici degli eventi per archiviare le informazioni che dell'applicazione può elaborare indipendentemente da Visualizzatore eventi.You can also use event-specific data to store information the application can process independently of the Event Viewer. Ad esempio, si potrebbe scrivere un visualizzatore in modo specifico per gli eventi o scrivere un programma che cerca il file di log e crea report che includono informazioni dai dati specifici degli eventi.For example, you could write a viewer specifically for your events, or write a program that scans the logfile and creates reports that include information from the event-specific data.

Oltre ai dati binari, è possibile specificare una categoria definita dall'applicazione e un identificatore eventi definito dall'applicazione.In addition to the binary data, you can specify an application-defined category and an application-defined event identifier. Il Visualizzatore eventi utilizza la categoria per filtrare gli eventi scritti da un'origine evento.The Event Viewer uses the category to filter events written by an event source. Il Visualizzatore eventi consente di visualizzare la categoria come valore numerico oppure è possibile usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.The Event Viewer can display the category as a numeric value, or it can use the category as a resource identifier to display a localized category string.

Nota

Il category parametro deve essere un valore positivo.The category parameter should be a positive value. I valori di categoria negativi vengono visualizzati come un numero positivo complemento nell'evento visualizzatore.Negative category values appear as a complementary positive number in the Event Viewer. Ad esempio, un -10 apparirà come 65,526, -1 come 65.535.For example, a -10 will appear as 65,526, a -1 as 65,535.

Per visualizzare le stringhe di categoria localizzata nel Visualizzatore eventi, è necessario usare un'origine evento configurato con un file di risorse di categoria e impostare il category a un identificatore di risorsa nel file di risorse della categoria.To display localized category strings in the Event Viewer, you must use an event source configured with a category resource file, and set the category to a resource identifier in the category resource file. Se l'origine evento non dispone di un file di risorse di categoria configurati o specificato category indicizza una stringa nel file di risorse di categoria, nel Visualizzatore eventi viene visualizzato il valore della categoria numerica per la voce.If the event source does not have a configured category resource file, or the specified category does not index a string in the category resource file, then the Event Viewer displays the numeric category value for that entry. Configurare il file di risorse di categoria, oltre al numero di stringhe di categoria nel file di risorse, usando il EventLogInstaller o il EventSourceCreationData classe.Configure the category resource file, along with the number of category strings in the resource file, using the EventLogInstaller or the EventSourceCreationData class.

Gli identificatori di evento, con l'origine evento, identificano in modo univoco un evento.Event identifiers, together with the event source, uniquely identify an event. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione alle quali vengono mappati.Each application can define its own numbered events and the description strings to which they map. I visualizzatori eventi visualizzati questi valori stringa per consentire all'utente di comprendere la causa dell'errore e suggerire le azioni da intraprendere.Event viewers display these string values to help the user understand what went wrong and suggest what actions to take.

Infine, è possibile specificare un EventLogEntryType per l'evento da scrivere nel registro eventi.Finally, you can specify an EventLogEntryType for the event being written to the event log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, operazioni riuscite o controllo con esito negativo.This parameter indicates whether the event type is error, warning, information, success audit, or failure audit.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source. Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, String, EventLogEntryType, Int32, Int16) WriteEntry(String, String, EventLogEntryType, Int32, Int16) WriteEntry(String, String, EventLogEntryType, Int32, Int16) WriteEntry(String, String, EventLogEntryType, Int32, Int16)

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione, usando l'origine eventi registrata specificata.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log, using the specified registered event source. Il parametro category può essere usato dal Visualizzatore eventi per filtrare gli eventi nel registro.The category can be used by the Event Viewer to filter events in the log.

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)

Parametri

source
String String String String

Origine con cui l'applicazione è registrata nel computer specificato.The source by which the application is registered on the specified computer.

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

eventID
Int32 Int32 Int32 Int32

Identificatore specifico dell'applicazione per l'evento.The application-specific identifier for the event.

category
Int16 Int16 Int16 Int16

Sottocategoria specifica per l'applicazione associata al messaggio.The application-specific subcategory associated with the message.

Eccezioni

Il valore source è una stringa vuota ("").The source value is an empty string ("").

In alternativa-or- Il valore di source è null.The source value is null.

In alternativa-or- eventID è minore di zero o maggiore di MaxValue.eventID is less than zero or greater than MaxValue.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

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

Commenti

Usare questo metodo per scrivere una voce con un parametro definito dall'applicazione category nel registro eventi, utilizzare un'origine che è già registrata come un'origine evento per il log appropriato.Use this method to write an entry with an application-defined category to the event log, using a source that is already registered as an event source for the appropriate log. Il Visualizzatore eventi utilizza la categoria per filtrare gli eventi scritti da un'origine evento.The Event Viewer uses the category to filter events written by an event source. Il Visualizzatore eventi consente di visualizzare la categoria come valore numerico oppure è possibile usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.The Event Viewer can display the category as a numeric value, or it can use the category as a resource identifier to display a localized category string.

Nota

Il category parametro deve essere un valore positivo.The category parameter should be a positive value. I valori di categoria negativi vengono visualizzati come un numero positivo complemento nell'evento visualizzatore.Negative category values appear as a complementary positive number in the Event Viewer. Ad esempio, un -10 viene visualizzata come 65,526, -1 come 65.535.For example, a -10 appears as 65,526, a -1 as 65,535.

Per visualizzare le stringhe di categoria localizzata nel Visualizzatore eventi, è necessario usare un'origine evento configurato con un file di risorse di categoria e impostare il category a un identificatore di risorsa nel file di risorse della categoria.To display localized category strings in the Event Viewer, you must use an event source configured with a category resource file, and set the category to a resource identifier in the category resource file. Se l'origine evento non dispone di un file di risorse di categoria configurati o specificato category indicizza una stringa nel file di risorse di categoria, nel Visualizzatore eventi viene visualizzato il valore della categoria numerica per la voce.If the event source does not have a configured category resource file, or the specified category does not index a string in the category resource file, then the Event Viewer displays the numeric category value for that entry. Configurare il file di risorse di categoria, oltre al numero di stringhe di categoria nel file di risorse, usando il EventLogInstaller o il EventSourceCreationData classe.Configure the category resource file, along with the number of category strings in the resource file, using the EventLogInstaller or the EventSourceCreationData class.

Oltre a categoria, è possibile specificare un identificatore di evento per l'evento da scrivere nel registro eventi.In addition to the category, you can specify an event identifier for the event being written to the event log. Identificatori di eventi, insieme all'origine evento, identificano in modo univoco un evento.Event identifiers, along with the event source, uniquely identify an event. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione alle quali vengono mappati.Each application can define its own numbered events and the description strings to which they map. I visualizzatori eventi visualizzati questi valori stringa per consentire all'utente di comprendere la causa dell'errore e suggerire le azioni da intraprendere.Event viewers display these string values to help the user understand what went wrong and suggest what actions to take.

Infine, è possibile specificare un EventLogEntryType per l'evento da scrivere nel registro eventi.Finally, you can specify an EventLogEntryType for the event being written to the event log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, operazioni riuscite o controllo con esito negativo.This parameter indicates whether the event type is error, warning, information, success audit, or failure audit.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source. Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione, e allega dati binari al messaggio.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log, and appends binary data to the message.

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())

Parametri

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

eventID
Int32 Int32 Int32 Int32

Identificatore specifico dell'applicazione per l'evento.The application-specific identifier for the event.

category
Int16 Int16 Int16 Int16

Sottocategoria specifica per l'applicazione associata al messaggio.The application-specific subcategory associated with the message.

rawData
Byte[]

Matrice di byte contenente i dati binari associati alla voce.An array of bytes that holds the binary data associated with the entry.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.The Source property of the EventLog has not been set.

In alternativa-or- Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.The method attempted to register a new event source, but the computer name in MachineName is not valid.

In alternativa-or- L'origine è già registrata con un log eventi diverso.The source is already registered for a different event log.

In alternativa-or- eventID è minore di zero o maggiore di MaxValue.eventID is less than zero or greater than MaxValue.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

// Create the source, if it does not already exist.
String^ myLogName = "myNewLog";
if (  !EventLog::SourceExists( "MySource" ) )
{
   EventLog::CreateEventSource( "MySource", myLogName );
   Console::WriteLine( "Creating EventSource" );
}
else
   myLogName = EventLog::LogNameFromSourceName( "MySource", "." );

// Create an EventLog and assign source.
EventLog^ myEventLog = gcnew 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.
array<Byte>^ myRawData = gcnew array<Byte>(4);
for ( int i = 0; i < 4; i++ )
{
   myRawData[ i ] = 1;
}
Console::WriteLine( "Writing to EventLog.. " );
myEventLog->WriteEntry( myMessage, myEventLogEntryType, myApplicatinEventId, myApplicatinCategoryId, myRawData );
// 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)

Commenti

Utilizzare questo overload per scrivere i dati specifici degli eventi definiti dall'applicazione nel registro eventi.Use this overload to write application-defined event-specific data to the event log. Il Visualizzatore eventi non interpreta i dati; Visualizza i dati non elaborati solo in un formato esadecimale e testo combinato.The Event Viewer does not interpret this data; it displays raw data only in a combined hexadecimal and text format. Usare i dati specifici degli eventi con parsimonia, includerlo solo se si è certi che possa risultare utile a un utente di debug del problema.Use event-specific data sparingly, including it only if you are sure it will be useful to someone debugging the problem. È anche possibile usare i dati specifici degli eventi per archiviare le informazioni che dell'applicazione può elaborare indipendentemente da Visualizzatore eventi.You can also use event-specific data to store information the application can process independently of the Event Viewer. Ad esempio, si potrebbe scrivere un visualizzatore in modo specifico per gli eventi o scrivere un programma che cerca il file di log e crea report che includono informazioni dai dati specifici degli eventi.For example, you could write a viewer specifically for your events, or write a program that scans the logfile and creates reports that include information from the event-specific data.

Oltre ai dati binari, è possibile specificare una categoria definita dall'applicazione e un identificatore eventi definito dall'applicazione.In addition to the binary data, you can specify an application-defined category and an application-defined event identifier. Il Visualizzatore eventi utilizza la categoria per filtrare gli eventi scritti da un'origine evento.The Event Viewer uses the category to filter events written by an event source. Il Visualizzatore eventi consente di visualizzare la categoria come valore numerico oppure è possibile usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.The Event Viewer can display the category as a numeric value, or it can use the category as a resource identifier to display a localized category string.

Nota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

Nota

Il category parametro deve essere un valore positivo.The category parameter should be a positive value. I valori di categoria negativi vengono visualizzati come un numero positivo complemento nell'evento visualizzatore.Negative category values appear as a complementary positive number in the Event Viewer. Ad esempio, un -10 viene visualizzata come 65,526, -1 come 65.535.For example, a -10 appears as 65,526, a -1 as 65,535.

Per visualizzare le stringhe di categoria localizzata nel Visualizzatore eventi, è necessario usare un'origine evento configurato con un file di risorse di categoria e impostare il category a un identificatore di risorsa nel file di risorse della categoria.To display localized category strings in the Event Viewer, you must use an event source configured with a category resource file, and set the category to a resource identifier in the category resource file. Se l'origine evento non dispone di un file di risorse di categoria configurati o specificato category indicizza una stringa nel file di risorse di categoria, nel Visualizzatore eventi viene visualizzato il valore della categoria numerica per la voce.If the event source does not have a configured category resource file, or the specified category does not index a string in the category resource file, then the Event Viewer displays the numeric category value for that entry. Configurare il file di risorse di categoria, oltre al numero di stringhe di categoria nel file di risorse, usando il EventLogInstaller o il EventSourceCreationData classe.Configure the category resource file, along with the number of category strings in the resource file, using the EventLogInstaller or the EventSourceCreationData class.

Identificatori di eventi, insieme all'origine evento, identificano in modo univoco un evento.Event identifiers, along with the event source, uniquely identify an event. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione alle quali vengono mappati.Each application can define its own numbered events and the description strings to which they map. I visualizzatori eventi visualizzati questi valori stringa per consentire all'utente di comprendere la causa dell'errore e suggerire le azioni da intraprendere.Event viewers display these string values to help the user understand what went wrong and suggest what actions to take.

Infine, è possibile specificare un EventLogEntryType per l'evento da scrivere nel registro eventi.Finally, you can specify an EventLogEntryType for the event being written to the event log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, operazioni riuscite o controllo con esito negativo.This parameter indicates whether the event type is error, warning, information, success audit, or failure audit.

È necessario impostare il Source proprietà di EventLog componente prima di poter scrivere voci nel log.You must set the Source property on your EventLog component before you can write entries to the log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source.

Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

Se l'origine specificata nel Source proprietà di questo EventLog istanza non è registrata nel computer in cui il componente sta scrivendo WriteEntry chiamate CreateEventSource e registra l'origine.If the source specified in the Source property of this EventLog instance is not registered on the computer that your component is writing to, WriteEntry calls CreateEventSource and registers the source.

Nota

Se non si specifica un MachineName per il EventLog istanza prima di chiamare CreateEventSource o WriteEntry, il computer locale (".") si presuppone che.If you do not specify a MachineName for your EventLog instance before you call CreateEventSource or WriteEntry, the local computer (".") is assumed.

Se il sistema deve registrare il Source tramite una chiamata a WriteEntry e il Log proprietà non è stata impostata sul EventLog per impostazione predefinita il log di istanza, nel registro applicazioni.If the system needs to register the Source through a call to WriteEntry and the Log property has not been set on your EventLog instance, the log defaults to the Application log.

Nota

Molte eccezioni elencate in precedenza vengono generate da errori generati durante il processo di registrazione di Source.Many exceptions listed above are generated by errors raised during the process of registering the Source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quelli previsti se il computer remoto non è in esecuzione in .NET Framework.If you write an entry to a remote computer, the value of the message (the text string) might not be what you expect if the remote computer is not running the .NET Framework.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, String, EventLogEntryType, Int32) WriteEntry(String, String, EventLogEntryType, Int32) WriteEntry(String, String, EventLogEntryType, Int32) WriteEntry(String, String, EventLogEntryType, Int32)

Scrive nel registro eventi una voce con il testo del messaggio indicato e con un identificatore eventi definito dall'applicazione, usando l'origine eventi registrata specificata.Writes an entry with the given message text and application-defined event identifier to the event log, using the specified registered event source.

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)

Parametri

source
String String String String

Origine con cui l'applicazione è registrata nel computer specificato.The source by which the application is registered on the specified computer.

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

eventID
Int32 Int32 Int32 Int32

Identificatore specifico dell'applicazione per l'evento.The application-specific identifier for the event.

Eccezioni

Il valore source è una stringa vuota ("").The source value is an empty string ("").

In alternativa-or- Il valore di source è null.The source value is null.

In alternativa-or- eventID è minore di zero o maggiore di MaxValue.eventID is less than zero or greater than MaxValue.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

// Create the source, if it does not already exist.
if (  !EventLog::SourceExists( "MySource" ) )
{
   EventLog::CreateEventSource( "MySource", "myNewLog" );
   Console::WriteLine( "Creating EventSource" );
}

// 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(!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)

Commenti

Usare questo metodo per scrivere una voce con un parametro definito dall'applicazione eventID nel registro eventi, utilizzare un'origine già registrato come un'origine evento per il log appropriato.Use this method to write an entry with an application-defined eventID to the event log, using a source already registered as an event source for the appropriate log. Il eventID, insieme a origine, identificare in modo univoco un evento.The eventID, along with the source, uniquely identify an event. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione alle quali vengono mappati.Each application can define its own numbered events and the description strings to which they map. I visualizzatori eventi presentano queste stringhe all'utente per consentire all'utente di comprendere la causa dell'errore e suggerire le azioni da intraprendere.Event viewers present these strings to the user to help the user understand what went wrong and suggest what actions to take.

Nota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

Oltre all'identificatore dell'evento, questo overload del metodo WriteEntry consente di specificare un EventLogEntryType per l'evento da scrivere nel registro eventi.In addition to the event identifier, this overload of WriteEntry lets you specify an EventLogEntryType for the event being written to the event log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, operazioni riuscite o controllo con esito negativo.This parameter indicates whether the event type is error, warning, information, success audit, or failure audit.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source. Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, EventLogEntryType, Int32, Int16) WriteEntry(String, EventLogEntryType, Int32, Int16) WriteEntry(String, EventLogEntryType, Int32, Int16) WriteEntry(String, EventLogEntryType, Int32, Int16)

Scrive nel registro eventi una voce con il testo del messaggio indicato, insieme a un identificatore eventi definito dall'applicazione e a una categoria definita dall'applicazione.Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log.

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)

Parametri

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

eventID
Int32 Int32 Int32 Int32

Identificatore specifico dell'applicazione per l'evento.The application-specific identifier for the event.

category
Int16 Int16 Int16 Int16

Sottocategoria specifica per l'applicazione associata al messaggio.The application-specific subcategory associated with the message.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.The Source property of the EventLog has not been set.

In alternativa-or- Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.The method attempted to register a new event source, but the computer name in MachineName is not valid.

In alternativa-or- L'origine è già registrata con un log eventi diverso.The source is already registered for a different event log.

In alternativa-or- eventID è minore di zero o maggiore di MaxValue.eventID is less than zero or greater than MaxValue.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

// Create an EventLog instance and assign its source.
EventLog^ myLog = gcnew 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.
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)

Commenti

Usare questo metodo per scrivere una voce con un parametro definito dall'applicazione category nel registro eventi.Use this method to write an entry with an application-defined category to the event log. Il Visualizzatore eventi utilizza la categoria per filtrare gli eventi scritti da un'origine evento.The Event Viewer uses the category to filter events written by an event source. Il Visualizzatore eventi consente di visualizzare la categoria come valore numerico oppure è possibile usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.The Event Viewer can display the category as a numeric value, or it can use the category as a resource identifier to display a localized category string.

Nota

Il category parametro deve essere un valore positivo.The category parameter should be a positive value. I valori di categoria negativi vengono visualizzati come un numero positivo complemento nell'evento visualizzatore.Negative category values appear as a complementary positive number in the Event Viewer. Ad esempio, un -10 viene visualizzata come 65,526, -1 come 65.535.For example, a -10 appears as 65,526, a -1 as 65,535.

Nota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

Per visualizzare le stringhe di categoria localizzata nel Visualizzatore eventi, è necessario usare un'origine evento configurato con un file di risorse di categoria e impostare il category a un identificatore di risorsa nel file di risorse della categoria.To display localized category strings in the Event Viewer, you must use an event source configured with a category resource file, and set the category to a resource identifier in the category resource file. Se l'origine evento non dispone di un file di risorse di categoria configurati o specificato category indicizza una stringa nel file di risorse di categoria, nel Visualizzatore eventi viene visualizzato il valore della categoria numerica per la voce.If the event source does not have a configured category resource file, or the specified category does not index a string in the category resource file, then the Event Viewer displays the numeric category value for that entry. Configurare il file di risorse di categoria, oltre al numero di stringhe di categoria nel file di risorse, usando il EventLogInstaller o il EventSourceCreationData classe.Configure the category resource file, along with the number of category strings in the resource file, using the EventLogInstaller or the EventSourceCreationData class.

Oltre a categoria, è possibile specificare un identificatore di evento per l'evento da scrivere nel registro eventi.In addition to the category, you can specify an event identifier for the event being written to the event log. Identificatori di eventi, insieme all'origine evento, identificano in modo univoco un evento.Event identifiers, along with the event source, uniquely identify an event. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione alle quali vengono mappati.Each application can define its own numbered events and the description strings to which they map. I visualizzatori eventi visualizzati questi valori stringa per consentire all'utente di comprendere la causa dell'errore e suggerire le azioni da intraprendere.Event viewers display these string values to help the user understand what went wrong and suggest what actions to take.

Infine, è possibile specificare un EventLogEntryType per l'evento da scrivere nel registro eventi.Finally, you can specify an EventLogEntryType for the event being written to the event log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, operazioni riuscite o controllo con esito negativo.This parameter indicates whether the event type is error, warning, information, success audit, or failure audit.

È necessario impostare il Source proprietà di EventLog componente prima di poter scrivere voci nel log.You must set the Source property on your EventLog component before you can write entries to the log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source.

Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

Se l'origine specificata nel Source proprietà di questo EventLog istanza non è registrata nel computer in cui il componente sta scrivendo WriteEntry chiamate CreateEventSource e registra l'origine.If the source specified in the Source property of this EventLog instance is not registered on the computer that your component is writing to, WriteEntry calls CreateEventSource and registers the source.

Nota

Se non si specifica un MachineName per il EventLog istanza prima di chiamare CreateEventSource o WriteEntry, il computer locale (".") si presuppone che.If you do not specify a MachineName for your EventLog instance before you call CreateEventSource or WriteEntry, the local computer (".") is assumed.

Se il sistema deve registrare il Source tramite una chiamata a WriteEntry e il Log proprietà non è stata impostata sul EventLog per impostazione predefinita il log di istanza, nel registro applicazioni.If the system needs to register the Source through a call to WriteEntry and the Log property has not been set on your EventLog instance, the log defaults to the Application log.

Nota

Molte eccezioni elencate in precedenza vengono generate da errori generati durante il processo di registrazione di Source.Many exceptions listed above are generated by errors raised during the process of registering the Source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quelli previsti se il computer remoto non è in esecuzione in .NET Framework.If you write an entry to a remote computer, the value of the message (the text string) might not be what you expect if the remote computer is not running the .NET Framework.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, EventLogEntryType) WriteEntry(String, EventLogEntryType) WriteEntry(String, EventLogEntryType) WriteEntry(String, EventLogEntryType)

Scrive nel registro eventi una voce relativa a errori, avvisi, informazioni, controlli riusciti o non riusciti, insieme al testo di un determinato messaggio.Writes an error, warning, information, success audit, or failure audit entry with the given message text to the event log.

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)

Parametri

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.The Source property of the EventLog has not been set.

In alternativa-or- Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.The method attempted to register a new event source, but the computer name in MachineName is not valid.

In alternativa-or- L'origine è già registrata con un log eventi diverso.The source is already registered for a different event log.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

L'esempio seguente scrive una voce di avviso in un log eventi, "MyNewLog", nel computer locale.The following example writes a warning entry to an event log, "MyNewLog", on the local computer.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog("MyNewLog");
   myLog->Source = "MyNewLogSource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing warning to event log.", EventLogEntryType::Warning );
}

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    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
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 ' Main 
End Class ' MySample

Commenti

Usare questo metodo per scrivere una voce di una determinata EventLogEntryType nel registro eventi.Use this method to write an entry of a specified EventLogEntryType to the event log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log.

Nota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

È necessario impostare il Source proprietà di EventLog componente prima di poter scrivere voci nel log.You must set the Source property on your EventLog component before you can write entries to the log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source.

Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

Se l'origine specificata nel Source proprietà di questo EventLog istanza non è registrata nel computer in cui il componente sta scrivendo WriteEntry chiamate CreateEventSource e registra l'origine.If the source specified in the Source property of this EventLog instance is not registered on the computer that your component is writing to, WriteEntry calls CreateEventSource and registers the source.

Nota

Se non si specifica un MachineName per il EventLog istanza prima di chiamare CreateEventSource o WriteEntry, il computer locale (".") si presuppone che.If you do not specify a MachineName for your EventLog instance before you call CreateEventSource or WriteEntry, the local computer (".") is assumed.

Se il sistema deve registrare il Source tramite una chiamata a WriteEntry e il Log proprietà non è stata impostata sul EventLog per impostazione predefinita il log di istanza, nel registro applicazioni.If the system needs to register the Source through a call to WriteEntry and the Log property has not been set on your EventLog instance, the log defaults to the Application log.

Nota

Molte eccezioni elencate in precedenza vengono generate da errori generati durante il processo di registrazione di Source.Many exceptions listed above are generated by errors raised during the process of registering the Source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quelli previsti se il computer remoto non è in esecuzione in .NET Framework.If you write an entry to a remote computer, the value of the message (the text string) might not be what you expect if the remote computer is not running the .NET Framework.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, EventLogEntryType, Int32) WriteEntry(String, EventLogEntryType, Int32) WriteEntry(String, EventLogEntryType, Int32) WriteEntry(String, EventLogEntryType, Int32)

Scrive nel registro eventi una voce con il testo del messaggio indicato e con un identificatore eventi definito dall'applicazione.Writes an entry with the given message text and application-defined event identifier to the event log.

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)

Parametri

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

eventID
Int32 Int32 Int32 Int32

Identificatore specifico dell'applicazione per l'evento.The application-specific identifier for the event.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.The Source property of the EventLog has not been set.

In alternativa-or- Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.The method attempted to register a new event source, but the computer name in MachineName is not valid.

In alternativa-or- L'origine è già registrata con un log eventi diverso.The source is already registered for a different event log.

In alternativa-or- eventID è minore di zero o maggiore di MaxValue.eventID is less than zero or greater than MaxValue.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

// Create an EventLog instance and assign its source.
EventLog^ myLog = gcnew 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.
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)

Commenti

Usare questo metodo per scrivere una voce con un parametro definito dall'applicazione eventID nel registro eventi.Use this method to write an entry with an application-defined eventID to the event log. Il eventID con l'origine identificano in modo univoco un evento.The eventID together with the source uniquely identify an event. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione alle quali vengono mappati.Each application can define its own numbered events and the description strings to which they map. I visualizzatori eventi visualizzati questi valori stringa per consentire all'utente di comprendere la causa dell'errore e suggerire le azioni da intraprendere.Event viewers display these string values to help the user understand what went wrong and suggest what actions to take.

Nota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

Oltre l'identificatore dell'evento, è possibile specificare un EventLogEntryType per l'evento da scrivere nel registro eventi.In addition to the event identifier, you can specify an EventLogEntryType for the event being written to the event log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, operazioni riuscite o controllo con esito negativo.This parameter indicates whether the event type is error, warning, information, success audit, or failure audit.

È necessario impostare il Source proprietà di EventLog componente prima di poter scrivere voci nel log.You must set the Source property on your EventLog component before you can write entries to the log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source.

Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

Se l'origine specificata nel Source proprietà di questo EventLog istanza non è registrata nel computer in cui il componente sta scrivendo WriteEntry chiamate CreateEventSource e registra l'origine.If the source specified in the Source property of this EventLog instance is not registered on the computer that your component is writing to, WriteEntry calls CreateEventSource and registers the source.

Nota

Se non si specifica un MachineName per il EventLog istanza prima di chiamare CreateEventSource o WriteEntry, il computer locale (".") si presuppone che.If you do not specify a MachineName for your EventLog instance before you call CreateEventSource or WriteEntry, the local computer (".") is assumed.

Se il sistema deve registrare il Source tramite una chiamata a WriteEntry e il Log proprietà non è stata impostata sul EventLog per impostazione predefinita il log di istanza, nel registro applicazioni.If the system needs to register the Source through a call to WriteEntry and the Log property has not been set on your EventLog instance, the log defaults to the Application log.

Nota

Molte eccezioni elencate in precedenza vengono generate da errori generati durante il processo di registrazione di Source.Many exceptions listed above are generated by errors raised during the process of registering the Source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quelli previsti se il computer remoto non è in esecuzione in .NET Framework.If you write an entry to a remote computer, the value of the message (the text string) might not be what you expect if the remote computer is not running the .NET Framework.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, String) WriteEntry(String, String) WriteEntry(String, String) WriteEntry(String, String)

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi, usando l'origine eventi registrata specificata.Writes an information type entry with the given message text to the event log, using the specified registered event source.

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)

Parametri

source
String String String String

Origine con cui l'applicazione è registrata nel computer specificato.The source by which the application is registered on the specified computer.

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

Eccezioni

Il valore source è una stringa vuota ("").The source value is an empty string ("").

In alternativa-or- Il valore di source è null.The source value is null.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

L'esempio seguente crea l'origine MySource se non esiste già e viene scritta una voce nel registro eventi MyNewLog.The following example creates the source MySource if it does not already exist, and writes an entry to the event log MyNewLog.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      EventLog::CreateEventSource( "MySource", "myNewLog" );
      Console::WriteLine( "CreatingEventSource" );
   }

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

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
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 ' Main 
End Class ' MySample 

Commenti

Usare questo metodo per scrivere una voce di informazioni nel registro eventi, utilizzare un'origine che è già registrata come un'origine evento per il log appropriato.Use this method to write an information entry to the event log, using a source that is already registered as an event source for the appropriate log. Se si desidera specificare qualsiasi altra EventLogEntryType, usare un overload diverso del WriteEntry.If you want to specify any other EventLogEntryType, use a different overload of WriteEntry.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source. Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String) WriteEntry(String) WriteEntry(String) WriteEntry(String)

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi.Writes an information type entry, with the given message text, to the event log.

public:
 void WriteEntry(System::String ^ message);
public void WriteEntry (string message);
member this.WriteEntry : string -> unit
Public Sub WriteEntry (message As String)

Parametri

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.The Source property of the EventLog has not been set.

In alternativa-or- Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.The method attempted to register a new event source, but the computer name in MachineName is not valid.

In alternativa-or- L'origine è già registrata con un log eventi diverso.The source is already registered for a different event log.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

L'esempio seguente crea l'origine MySource se non esiste già e viene scritta una voce nel registro eventi MyNewLog.The following example creates the source MySource if it does not already exist, and writes an entry to the event log MyNewLog.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int 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" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}

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
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 'Main 
End Class 'MySample

Commenti

Usare questo metodo per scrivere una voce di informazioni nel log eventi associato a questo EventLog istanza.Use this method to write an information entry to the event log associated with this EventLog instance. Se si desidera specificare qualsiasi altra EventLogEntryType, usare un overload diverso del WriteEntry.If you want to specify any other EventLogEntryType, use a different overload of WriteEntry.

Nota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

È necessario impostare il Source proprietà di EventLog componente prima di poter scrivere voci nel log.You must set the Source property on your EventLog component before you can write entries to the log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source.

Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

Se l'origine specificata nel Source proprietà di questo EventLog istanza non è registrata nel computer in cui il componente sta scrivendo WriteEntry chiamate CreateEventSource e registra l'origine.If the source specified in the Source property of this EventLog instance is not registered on the computer that your component is writing to, WriteEntry calls CreateEventSource and registers the source.

Nota

Se non si specifica un MachineName per il EventLog istanza prima di chiamare CreateEventSource o WriteEntry, il computer locale (".") si presuppone che.If you do not specify a MachineName for your EventLog instance before you call CreateEventSource or WriteEntry, the local computer (".") is assumed.

Se il sistema deve registrare il Source tramite una chiamata a WriteEntry e il Log proprietà non è stata impostata sul EventLog per impostazione predefinita il log di istanza, nel registro applicazioni.If the system needs to register the Source through a call to WriteEntry and the Log property has not been set on your EventLog instance, the log defaults to the Application log.

Nota

Molte eccezioni elencate in precedenza vengono generati da errori generati durante il processo di registrazione di Source.Many of the exceptions listed above are generated by errors raised during the process of registering the Source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quelli previsti se il computer remoto non è in esecuzione in .NET Framework.If you write an entry to a remote computer, the value of the message (the text string) might not be what you expect if the remote computer is not running the .NET Framework.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

WriteEntry(String, String, EventLogEntryType) WriteEntry(String, String, EventLogEntryType) WriteEntry(String, String, EventLogEntryType) WriteEntry(String, String, EventLogEntryType)

Scrive nel registro eventi una voce relativa a errori, errori, avvisi, informazioni, controlli riusciti o controlli non riusciti, insieme al testo di un determinato messaggio, usando l'origine eventi registrata specificata.Writes an error, warning, information, success audit, or failure audit entry with the given message text to the event log, using the specified registered event source.

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)

Parametri

source
String String String String

Origine con cui l'applicazione è registrata nel computer specificato.The source by which the application is registered on the specified computer.

message
String String String String

Stringa da scrivere nel registro eventi.The string to write to the event log.

Eccezioni

Il valore source è una stringa vuota ("").The source value is an empty string ("").

In alternativa-or- Il valore di source è null.The source value is null.

In alternativa-or- La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).The message string is longer than 31,839 bytes (32,766 bytes on Windows operating systems before Windows Vista).

In alternativa-or- A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.The source name results in a registry key path longer than 254 characters.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.The registry key for the event log could not be opened.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi.The operating system reported an error when writing the event entry to the event log. Non è disponibile un codice di errore di Windows.A Windows error code is not available.

Esempi

L'esempio seguente scrive una voce di avviso in un log eventi, "MyNewLog", nel computer locale.The following example writes a warning entry to an event log, "MyNewLog", on the local computer.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Write an informational entry to the event log.    
   EventLog::WriteEntry( "MySource", "Writing warning to event log.", EventLogEntryType::Warning );
}

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    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
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 ' Main 
End Class ' MySample

Commenti

Usare questo metodo per scrivere una voce di una determinata EventLogEntryType nel registro eventi, utilizzare un'origine già registrato come un'origine evento per il log appropriato.Use this method to write an entry of a specified EventLogEntryType to the event log, using a source already registered as an event source for the appropriate log. Il type è indicato dall'icona e il testo nella colonna di tipo nel Visualizzatore eventi per un log.The type is indicated by an icon and text in the Type column in the Event Viewer for a log.

Nota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), in quanto lo considera come una stringa di inserimento nel Visualizzatore eventi.The message string cannot contain %n, where n is an integer value (for example, %1), because the event viewer treats it as an insertion string. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.Because an Internet Protocol, version 6 (IPv6) address can contain this character sequence, you cannot log an event message that contains an IPv6 address.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must create and configure the event source before writing the first entry with the source. Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. In questo modo ora il sistema operativo aggiornare l'elenco delle origini degli eventi registrati e la relativa configurazione.This allows time for the operating system to refresh its list of registered event sources and their configuration. Se il sistema operativo non è aggiornato l'elenco di origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. È possibile configurare una nuova origine usando un EventLogInstaller, o tramite il CreateEventSource (metodo).You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.You must have administrative rights on the computer to create a new event source.

L'origine deve essere configurato per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi di; non usa un file di risorse localizzabili di messaggio.The WriteEntry method writes the given string directly to the event log; it does not use a localizable message resource file. Usare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.Use the WriteEvent method to write events using a localized message resource file.

Se l'applicazione scrive le voci con identificatori di risorsa e i valori stringa, è necessario registrare due origini dati separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine dei file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Quindi creare un'origine diversa senza i file di risorse e usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente il registro eventi usando tale origine.Then create a different source without resource files, and use that source in the WriteEntry method to write strings directly to the event log using that source.

Nota

Se il message parametro contiene un carattere null, il messaggio nel registro eventi viene terminato in corrispondenza del carattere null.If the message parameter contains a NUL character, the message in the event log is terminated at the NUL character.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Vedi anche

Si applica a