EventLog.WriteEntry Metodo

Definizione

Scrive una voce nel registro eventi.

Overload

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.

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. Il parametro category può essere usato dal Visualizzatore eventi per filtrare gli eventi nel registro.

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.

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.

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.

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.

WriteEntry(String, EventLogEntryType, Int32)

Scrive nel registro eventi una voce con il testo del messaggio indicato e con un identificatore eventi definito dall'applicazione.

WriteEntry(String, String)

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi, usando l'origine eventi registrata specificata.

WriteEntry(String)

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi.

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.

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

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

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.

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

Origine con cui l'applicazione è registrata nel computer specificato.

message
String

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

eventID
Int32

Identificatore specifico dell'applicazione per l'evento.

category
Int16

Sottocategoria specifica per l'applicazione associata al messaggio.

rawData
Byte[]

Matrice di byte contenente i dati binari associati alla voce.

Eccezioni

Il valore source è una stringa vuota ("").

-oppure-

Il valore source è null.

-oppure-

eventID è minore di zero o maggiore di UInt16.MaxValue.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

type non è un oggetto EventLogEntryType valido.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

//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 dell'evento definiti dall'applicazione nel registro eventi usando un'origine già registrata come origine evento per il log appropriato. Il Visualizzatore eventi non interpreta questi dati e visualizza i dati non elaborati solo in un formato combinato esadecimale e di testo. Usare i dati specifici dell'evento con moderazione; includerlo solo se si è certi che sarà utile. È anche possibile usare dati specifici dell'evento per archiviare le informazioni che l'applicazione può elaborare indipendentemente dal Visualizzatore eventi. Ad esempio, è possibile scrivere un visualizzatore in modo specifico per gli eventi o scrivere un programma che analizza il file di log e crea report che includono informazioni dai dati specifici dell'evento.

Oltre ai dati binari, è possibile specificare una categoria definita dall'applicazione e un identificatore di evento definito dall'applicazione. Il Visualizzatore eventi usa la categoria per filtrare gli eventi scritti da un'origine evento. Il Visualizzatore eventi può visualizzare la categoria come valore numerico oppure può usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.

Nota

Il category parametro deve essere un valore positivo. I valori di categoria negativi vengono visualizzati come numero positivo complementare nel Visualizzatore eventi. Ad esempio, un -10 verrà visualizzato come 65.526, un -1 come 65.535.

Per visualizzare le stringhe di categoria localizzate nel Visualizzatore eventi, è necessario usare un'origine evento configurata con un file di risorse di categoria e impostare su category un identificatore di risorsa nel file di risorse di categoria. Se l'origine evento non dispone di un file di risorse di categoria configurato o se l'oggetto specificato category non indicizza una stringa nel file di risorse di categoria, il Visualizzatore eventi visualizza il valore di categoria numerico per tale voce. Configurare il file di risorse di categoria, insieme al numero di stringhe di categoria nel file di risorse, usando o EventLogInstaller la EventSourceCreationData classe .

Gli identificatori di evento, insieme all'origine evento, identificano in modo univoco un evento. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione a cui eseguono il mapping. I visualizzatori di eventi visualizzano questi valori stringa per aiutare l'utente a comprendere cosa è andato storto e suggerire quali azioni eseguire.

È infine possibile specificare un EventLogEntryType oggetto per l'evento scritto nel registro eventi. L'oggetto type è indicato da un'icona e da un testo nella colonna Tipo nel Visualizzatore eventi per un log. Questo parametro indica se il tipo di evento è error, warning, information, success audit o failure audit.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine. Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi e non usa un file di risorse del messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse messaggio localizzato.

Se l'applicazione scrive voci usando sia identificatori di risorsa che valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se il message parametro contiene un carattere NUL, il messaggio nel registro eventi viene terminato in corrispondenza del carattere NUL.

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Ip Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

Vedi anche

Si applica a

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

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

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. Il parametro category può essere usato dal Visualizzatore eventi per filtrare gli eventi nel registro.

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

Origine con cui l'applicazione è registrata nel computer specificato.

message
String

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

eventID
Int32

Identificatore specifico dell'applicazione per l'evento.

category
Int16

Sottocategoria specifica per l'applicazione associata al messaggio.

Eccezioni

Il valore source è una stringa vuota ("").

-oppure-

Il valore source è null.

-oppure-

eventID è minore di zero o maggiore di UInt16.MaxValue.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

type non è un oggetto EventLogEntryType valido.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

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

Utilizzare questo metodo per scrivere una voce con un'applicazione definita category nel registro eventi, usando un'origine già registrata come origine evento per il log appropriato. Il Visualizzatore eventi usa la categoria per filtrare gli eventi scritti da un'origine evento. Il Visualizzatore eventi può visualizzare la categoria come valore numerico oppure può usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.

Nota

Il category parametro deve essere un valore positivo. I valori di categoria negativi vengono visualizzati come numero positivo complementare nel Visualizzatore eventi. Ad esempio, un -10 viene visualizzato come 65.526, un -1 come 65.535.

Per visualizzare le stringhe di categoria localizzate nel Visualizzatore eventi, è necessario usare un'origine evento configurata con un file di risorse di categoria e impostare su category un identificatore di risorsa nel file di risorse di categoria. Se l'origine evento non dispone di un file di risorse di categoria configurato o se l'oggetto specificato category non indicizza una stringa nel file di risorse di categoria, il Visualizzatore eventi visualizza il valore di categoria numerico per tale voce. Configurare il file di risorse di categoria, insieme al numero di stringhe di categoria nel file di risorse, usando o EventLogInstaller la EventSourceCreationData classe .

Oltre alla categoria, è possibile specificare un identificatore di evento per l'evento scritto nel registro eventi. Gli identificatori di evento, insieme all'origine evento, identificano in modo univoco un evento. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione a cui eseguono il mapping. I visualizzatori di eventi visualizzano questi valori stringa per aiutare l'utente a comprendere cosa è andato storto e suggerire quali azioni eseguire.

È infine possibile specificare un EventLogEntryType oggetto per l'evento scritto nel registro eventi. L'oggetto type è indicato da un'icona e da un testo nella colonna Tipo nel Visualizzatore eventi per un log. Questo parametro indica se il tipo di evento è error, warning, information, success audit o failure audit.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine. Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi e non usa un file di risorse del messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse messaggio localizzato.

Se l'applicazione scrive voci usando sia identificatori di risorsa che valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se il message parametro contiene un carattere NUL, il messaggio nel registro eventi viene terminato in corrispondenza del carattere NUL.

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Ip Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

Vedi anche

Si applica a

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

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

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.

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

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

eventID
Int32

Identificatore specifico dell'applicazione per l'evento.

category
Int16

Sottocategoria specifica per l'applicazione associata al messaggio.

rawData
Byte[]

Matrice di byte contenente i dati binari associati alla voce.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.

-oppure-

Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.

-oppure-

L'origine è già registrata con un log eventi diverso.

-oppure-

eventID è minore di zero o maggiore di UInt16.MaxValue.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

type non è un oggetto EventLogEntryType valido.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

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

Usare questo overload per scrivere dati specifici dell'evento definiti dall'applicazione nel registro eventi. Il Visualizzatore eventi non interpreta questi dati e visualizza i dati non elaborati solo in un formato combinato esadecimale e di testo. Usare con moderazione i dati specifici dell'evento, inclusi solo se si è certi che sarà utile per un utente che esegue il debug del problema. È anche possibile usare dati specifici dell'evento per archiviare le informazioni che l'applicazione può elaborare indipendentemente dal Visualizzatore eventi. Ad esempio, è possibile scrivere un visualizzatore in modo specifico per gli eventi o scrivere un programma che analizza il file di log e crea report che includono informazioni dai dati specifici dell'evento.

Oltre ai dati binari, è possibile specificare una categoria definita dall'applicazione e un identificatore di evento definito dall'applicazione. Il Visualizzatore eventi usa la categoria per filtrare gli eventi scritti da un'origine evento. Il Visualizzatore eventi può visualizzare la categoria come valore numerico oppure può usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.

Nota

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Ip Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

Nota

Il category parametro deve essere un valore positivo. I valori di categoria negativi vengono visualizzati come numero positivo complementare nel Visualizzatore eventi. Ad esempio, un -10 viene visualizzato come 65.526, un -1 come 65.535.

Per visualizzare le stringhe di categoria localizzate nel Visualizzatore eventi, è necessario usare un'origine evento configurata con un file di risorse di categoria e impostare su category un identificatore di risorsa nel file di risorse di categoria. Se l'origine evento non dispone di un file di risorse di categoria configurato o se l'oggetto specificato category non indicizza una stringa nel file di risorse di categoria, il Visualizzatore eventi visualizza il valore di categoria numerico per tale voce. Configurare il file di risorse di categoria, insieme al numero di stringhe di categoria nel file di risorse, usando o EventLogInstaller la EventSourceCreationData classe .

Gli identificatori di evento, insieme all'origine evento, identificano in modo univoco un evento. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione a cui eseguono il mapping. I visualizzatori di eventi visualizzano questi valori stringa per aiutare l'utente a comprendere cosa è andato storto e suggerire quali azioni eseguire.

È infine possibile specificare un EventLogEntryType oggetto per l'evento scritto nel registro eventi. L'oggetto type è indicato da un'icona e da un testo nella colonna Tipo nel Visualizzatore eventi per un log. Questo parametro indica se il tipo di evento è error, warning, information, success audit o failure audit.

È necessario impostare la Source proprietà nel EventLog componente prima di poter scrivere voci nel log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.

Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.

Se l'origine specificata nella Source proprietà di questa EventLog istanza non è registrata nel computer in cui il componente sta scrivendo, WriteEntry chiama CreateEventSource e registra l'origine.

Nota

Se non si specifica un oggetto per l'istanza MachineNameEventLog prima di chiamare CreateEventSource o WriteEntry, verrà utilizzato il computer locale (".").

Se il sistema deve registrare tramite Source una chiamata a WriteEntry e la Log proprietà non è stata impostata nell'istanza EventLog , per impostazione predefinita il log viene impostato sul registro applicazioni.

Nota

Molte eccezioni elencate in precedenza vengono generate da errori generati durante il processo di registrazione Sourcedi .

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi e non usa un file di risorse del messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse messaggio localizzato.

Se l'applicazione scrive voci usando sia identificatori di risorsa che valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quello previsto se il computer remoto non esegue .NET Framework.

Nota

Se il parametro contiene un carattere NUL, il message messaggio nel registro eventi viene terminato al carattere NUL.

Vedi anche

Si applica a

WriteEntry(String, String, EventLogEntryType, Int32)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

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.

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

Origine con cui l'applicazione è registrata nel computer specificato.

message
String

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

eventID
Int32

Identificatore specifico dell'applicazione per l'evento.

Eccezioni

Il valore source è una stringa vuota ("").

-oppure-

Il valore source è null.

-oppure-

eventID è minore di zero o maggiore di UInt16.MaxValue.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

type non è un oggetto EventLogEntryType valido.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

// 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'applicazione definita eventID nel registro eventi usando un'origine già registrata come origine evento per il log appropriato. Insieme eventIDall'origine, identificare in modo univoco un evento. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione a cui vengono mappate. I visualizzatori di eventi presentano queste stringhe all'utente per aiutare l'utente a capire cosa è andato male e suggerire le azioni da eseguire.

Nota

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Internet Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

Oltre all'identificatore di evento, questo overload di WriteEntry consente di specificare un EventLogEntryType oggetto per l'evento scritto nel registro eventi. L'oggetto type è indicato da un'icona e un testo nella colonna Tipo nella Visualizzatore eventi per un log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, controllo dell'esito positivo o controllo degli errori.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine. Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato il relativo elenco di origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi. Non usa un file di risorse di messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse di messaggi localizzato.

Se l'applicazione scrive voci con identificatori di risorsa e valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine WriteEvent con i file di risorse e quindi usare tale origine nel metodo per scrivere voci usando identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se il parametro contiene un carattere NUL, il message messaggio nel registro eventi viene terminato al carattere NUL.

Vedi anche

Si applica a

WriteEntry(String, EventLogEntryType, Int32, Int16)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

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.

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

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

eventID
Int32

Identificatore specifico dell'applicazione per l'evento.

category
Int16

Sottocategoria specifica per l'applicazione associata al messaggio.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.

-oppure-

Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.

-oppure-

L'origine è già registrata con un log eventi diverso.

-oppure-

eventID è minore di zero o maggiore di UInt16.MaxValue.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

type non è un oggetto EventLogEntryType valido.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

// 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'applicazione definita category nel registro eventi. Il Visualizzatore eventi usa la categoria per filtrare gli eventi scritti da un'origine evento. Il Visualizzatore eventi può visualizzare la categoria come valore numerico oppure può usare la categoria come identificatore di risorsa per visualizzare una stringa di categoria localizzata.

Nota

Il category parametro deve essere un valore positivo. I valori di categoria negativi vengono visualizzati come numero positivo complementare nella Visualizzatore eventi. Ad esempio, viene visualizzato un -10 come 65.526, un -1 come 65.535.

Nota

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Internet Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

Per visualizzare le stringhe di categoria localizzate nella Visualizzatore eventi, è necessario usare un'origine evento configurata con un file di risorse di categoria e impostare su category un identificatore di risorsa nel file di risorse di categoria. Se l'origine evento non dispone di un file di risorse di categoria configurato oppure l'oggetto specificato category non indicizza una stringa nel file di risorse di categoria, il Visualizzatore eventi visualizza il valore della categoria numerica per tale voce. Configurare il file di risorse di categoria, insieme al numero di stringhe di categoria nel file di risorse, usando o EventLogInstaller la EventSourceCreationData classe .

Oltre alla categoria, è possibile specificare un identificatore di evento per l'evento scritto nel registro eventi. Identificatori di evento, insieme all'origine evento, identificano in modo univoco un evento. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione a cui vengono mappate. I visualizzatori eventi visualizzano questi valori di stringa per aiutare l'utente a capire cosa è andato male e suggerire le azioni da eseguire.

Infine, è possibile specificare un EventLogEntryType oggetto per l'evento scritto nel registro eventi. L'oggetto type è indicato da un'icona e un testo nella colonna Tipo nella Visualizzatore eventi per un log. Questo parametro indica se il tipo di evento è errore, avviso, informazioni, controllo dell'esito positivo o controllo degli errori.

È necessario impostare la Source proprietà EventLog sul componente prima di poter scrivere voci nel log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.

Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato il relativo elenco di origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.

Se l'origine specificata nella proprietà di questa EventLog istanza non è registrata nel Source computer in cui il componente sta scrivendo, WriteEntry chiama CreateEventSource e registra l'origine.

Nota

Se non si specifica un MachineName oggetto per l'istanza EventLog prima di chiamare CreateEventSource o WriteEntry, viene assunto il computer locale (".").

Se il sistema deve registrare l'oggetto Source tramite una chiamata a WriteEntry e la Log proprietà non è stata impostata nell'istanza EventLog , il log viene impostato per impostazione predefinita sul log dell'applicazione.

Nota

Molte eccezioni elencate sopra vengono generate da errori generati durante il processo di registrazione dell'oggetto Source.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi. Non usa un file di risorse di messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse di messaggi localizzato.

Se l'applicazione scrive voci usando sia identificatori di risorsa che valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quello previsto se il computer remoto non esegue .NET Framework.

Nota

Se il message parametro contiene un carattere NUL, il messaggio nel registro eventi viene terminato in corrispondenza del carattere NUL.

Vedi anche

Si applica a

WriteEntry(String, EventLogEntryType)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Scrive nel registro eventi una voce relativa a errori, avvisi, informazioni, controlli riusciti o non riusciti, insieme al testo di un determinato messaggio.

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

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.

-oppure-

Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.

-oppure-

L'origine è già registrata con un log eventi diverso.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

type non è un oggetto EventLogEntryType valido.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

L'esempio seguente scrive una voce di avviso in un registro eventi, "MyNewLog", nel computer locale.

#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 MySample1
{

    public static void Main()
    {

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

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

Imports System.Diagnostics
Imports System.Threading

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

Commenti

Utilizzare questo metodo per scrivere una voce di un oggetto specificato EventLogEntryType nel registro eventi. L'oggetto type è indicato da un'icona e da un testo nella colonna Tipo nel Visualizzatore eventi per un log.

Nota

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Ip Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

È necessario impostare la Source proprietà nel EventLog componente prima di poter scrivere voci nel log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.

Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.

Se l'origine specificata nella Source proprietà di questa EventLog istanza non è registrata nel computer in cui il componente sta scrivendo, WriteEntry chiama CreateEventSource e registra l'origine.

Nota

Se non si specifica un oggetto per l'istanza MachineNameEventLog prima di chiamare CreateEventSource o WriteEntry, verrà utilizzato il computer locale (".").

Se il sistema deve registrare tramite Source una chiamata a WriteEntry e la Log proprietà non è stata impostata nell'istanza EventLog , per impostazione predefinita il log viene impostato sul registro applicazioni.

Nota

Molte eccezioni elencate in precedenza vengono generate da errori generati durante il processo di registrazione Sourcedi .

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi e non usa un file di risorse del messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse messaggio localizzato.

Se l'applicazione scrive voci usando sia identificatori di risorsa che valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quello previsto se il computer remoto non esegue .NET Framework.

Nota

Se il message parametro contiene un carattere NUL, il messaggio nel registro eventi viene terminato in corrispondenza del carattere NUL.

Vedi anche

Si applica a

WriteEntry(String, EventLogEntryType, Int32)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Scrive nel registro eventi una voce con il testo del messaggio indicato e con un identificatore eventi definito dall'applicazione.

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

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

eventID
Int32

Identificatore specifico dell'applicazione per l'evento.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.

-oppure-

Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.

-oppure-

L'origine è già registrata con un log eventi diverso.

-oppure-

eventID è minore di zero o maggiore di UInt16.MaxValue.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

type non è un oggetto EventLogEntryType valido.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

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

Utilizzare questo metodo per scrivere una voce con un'applicazione definita eventID nel registro eventi. Insieme eventID all'origine identifica in modo univoco un evento. Ogni applicazione può definire i propri eventi numerati e le stringhe di descrizione a cui eseguono il mapping. I visualizzatori di eventi visualizzano questi valori stringa per aiutare l'utente a comprendere cosa è andato storto e suggerire quali azioni eseguire.

Nota

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Ip Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

Oltre all'identificatore dell'evento, è possibile specificare un EventLogEntryType oggetto per l'evento scritto nel registro eventi. L'oggetto type è indicato da un'icona e da un testo nella colonna Tipo nel Visualizzatore eventi per un log. Questo parametro indica se il tipo di evento è error, warning, information, success audit o failure audit.

È necessario impostare la Source proprietà nel EventLog componente prima di poter scrivere voci nel log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.

Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.

Se l'origine specificata nella Source proprietà di questa EventLog istanza non è registrata nel computer in cui il componente sta scrivendo, WriteEntry chiama CreateEventSource e registra l'origine.

Nota

Se non si specifica un oggetto per l'istanza MachineNameEventLog prima di chiamare CreateEventSource o WriteEntry, verrà utilizzato il computer locale (".").

Se il sistema deve registrare tramite Source una chiamata a WriteEntry e la Log proprietà non è stata impostata nell'istanza EventLog , per impostazione predefinita il log viene impostato sul registro applicazioni.

Nota

Molte eccezioni elencate in precedenza vengono generate da errori generati durante il processo di registrazione Sourcedi .

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi e non usa un file di risorse del messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse messaggio localizzato.

Se l'applicazione scrive voci usando sia identificatori di risorsa che valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quello previsto se il computer remoto non esegue .NET Framework.

Nota

Se il parametro contiene un carattere NUL, il message messaggio nel registro eventi viene terminato al carattere NUL.

Vedi anche

Si applica a

WriteEntry(String, String)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi, usando l'origine eventi registrata specificata.

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

Origine con cui l'applicazione è registrata nel computer specificato.

message
String

Stringa da scrivere nel registro eventi.

Eccezioni

Il valore source è una stringa vuota ("").

-oppure-

Il valore source è null.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

Nell'esempio seguente viene creata l'origine MySource se non esiste già e scrive una voce nel registro MyNewLogeventi .

#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.Diagnostics
Imports System.Threading

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

Commenti

Usare questo metodo per scrivere una voce di informazioni nel registro eventi usando un'origine già registrata come origine evento per il log appropriato. Se si vuole specificare qualsiasi altro EventLogEntryType, usare un overload diverso di WriteEntry.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine. Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato il relativo elenco di origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi. Non usa un file di risorse di messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse di messaggi localizzato.

Se l'applicazione scrive voci con identificatori di risorsa e valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine WriteEvent con i file di risorse e quindi usare tale origine nel metodo per scrivere voci usando identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se il parametro contiene un carattere NUL, il message messaggio nel registro eventi viene terminato al carattere NUL.

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Internet Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

Vedi anche

Si applica a

WriteEntry(String)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Scrive una voce di tipo informativo con il testo del messaggio specificato nel registro eventi.

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

Stringa da scrivere nel registro eventi.

Eccezioni

La proprietà Source dell'oggetto EventLog non è stata impostata.

-oppure-

Il metodo ha tentato di registrare una nuova origine eventi, ma il nome del computer in MachineName non è valido.

-oppure-

L'origine è già registrata con un log eventi diverso.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

Nell'esempio seguente viene creata l'origine MySource se non esiste già e scrive una voce nel registro MyNewLogeventi .

#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.Diagnostics
Imports System.Threading

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

Commenti

Usare questo metodo per scrivere una voce di informazioni nel registro eventi associato a questa EventLog istanza. Se si vuole specificare qualsiasi altro EventLogEntryType, usare un overload diverso di WriteEntry.

Nota

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Internet Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

È necessario impostare la Source proprietà EventLog sul componente prima di poter scrivere voci nel log. È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.

Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato il relativo elenco di origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.

Se l'origine specificata nella proprietà di questa EventLog istanza non è registrata nel Source computer in cui il componente sta scrivendo, WriteEntry chiama CreateEventSource e registra l'origine.

Nota

Se non si specifica un MachineName oggetto per l'istanza EventLog prima di chiamare CreateEventSource o WriteEntry, viene assunto il computer locale (".").

Se il sistema deve registrare l'oggetto Source tramite una chiamata a WriteEntry e la Log proprietà non è stata impostata nell'istanza EventLog , il log viene impostato per impostazione predefinita sul log dell'applicazione.

Nota

Molte delle eccezioni elencate sopra vengono generate da errori generati durante il processo di registrazione di Source.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi. Non usa un file di risorse di messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse di messaggi localizzato.

Se l'applicazione scrive voci con identificatori di risorsa e valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine WriteEvent con i file di risorse e quindi usare tale origine nel metodo per scrivere voci usando identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se si scrive una voce in un computer remoto, il valore del messaggio (stringa di testo) potrebbe non essere quello previsto se il computer remoto non esegue .NET Framework.

Nota

Se il parametro contiene un carattere NUL, il message messaggio nel registro eventi viene terminato al carattere NUL.

Vedi anche

Si applica a

WriteEntry(String, String, EventLogEntryType)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

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.

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

Origine con cui l'applicazione è registrata nel computer specificato.

message
String

Stringa da scrivere nel registro eventi.

type
EventLogEntryType

Uno dei valori di EventLogEntryType.

Eccezioni

Il valore source è una stringa vuota ("").

-oppure-

Il valore source è null.

-oppure-

La stringa del messaggio è maggiore di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

A causa del nome origine una chiave del Registro di sistema risulta più lunga di 254 caratteri.

Non è possibile aprire la chiave del Registro di sistema per il log eventi.

type non è un oggetto EventLogEntryType valido.

È stato riscontrato un errore durante la scrittura della voce di evento nel log eventi. Non è disponibile un codice di errore di Windows.

Esempio

L'esempio seguente scrive una voce di avviso in un registro eventi, "MyNewLog", nel computer locale.

#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 MySample2
{

    public static void Main()
    {

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

Imports System.Diagnostics
Imports System.Threading

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

Commenti

Usare questo metodo per scrivere una voce di un oggetto specificato EventLogEntryType nel registro eventi, usando un'origine già registrata come origine evento per il log appropriato. L'oggetto type è indicato da un'icona e un testo nella colonna Tipo nella Visualizzatore eventi per un log.

Nota

La message stringa non può contenere %n, dove n è un valore intero ,ad esempio %1, perché il visualizzatore eventi lo considera come stringa di inserimento. Poiché un indirizzo Internet Protocol versione 6 (IPv6) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.

È necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine. Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato il relativo elenco di origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . È necessario disporre dei diritti amministrativi nel computer per creare una nuova origine evento.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Il WriteEntry metodo scrive la stringa specificata direttamente nel registro eventi. Non usa un file di risorse di messaggio localizzabile. Usare il WriteEvent metodo per scrivere eventi usando un file di risorse di messaggi localizzato.

Se l'applicazione scrive voci con identificatori di risorsa e valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine WriteEvent con i file di risorse e quindi usare tale origine nel metodo per scrivere voci usando identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Nota

Se il parametro contiene un carattere NUL, il message messaggio nel registro eventi viene terminato al carattere NUL.

Vedi anche

Si applica a