EventLog.WriteEntry Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Scrive una voce nel registro eventi.
Overload
| Nome | Descrizione |
|---|---|
| WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[]) |
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi (usando l'origine evento registrata specificata) e accoda i dati binari al messaggio. |
| WriteEntry(String, String, EventLogEntryType, Int32, Int16) |
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi, usando l'origine evento registrata specificata. Può |
| WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[]) |
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi e aggiunge dati binari al messaggio. |
| WriteEntry(String, String, EventLogEntryType, Int32) |
Scrive una voce con il testo del messaggio specificato e l'identificatore dell'evento definito dall'applicazione nel registro eventi, usando l'origine evento registrata specificata. |
| WriteEntry(String, EventLogEntryType, Int32, Int16) |
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi. |
| WriteEntry(String, EventLogEntryType) |
Scrive una voce di controllo di errore, avviso, informazioni, controllo riuscito o errore con il testo del messaggio specificato nel registro eventi. |
| WriteEntry(String, EventLogEntryType, Int32) |
Scrive una voce con il testo del messaggio specificato e l'identificatore dell'evento definito dall'applicazione nel registro eventi. |
| WriteEntry(String, String) |
Scrive una voce del tipo di informazioni con il testo del messaggio specificato nel registro eventi, utilizzando l'origine evento registrata specificata. |
| WriteEntry(String) |
Scrive una voce del tipo di informazioni, con il testo del messaggio specificato, nel registro eventi. |
| WriteEntry(String, String, EventLogEntryType) |
Scrive un errore, un avviso, informazioni, un controllo di esito positivo o una voce di controllo degli errori con il testo del messaggio specificato nel registro eventi, utilizzando l'origine evento registrata specificata. |
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi (usando l'origine evento registrata specificata) e accoda i 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 in base alla quale l'applicazione viene registrata nel computer specificato.
- message
- String
Stringa da scrivere nel registro eventi.
- type
- EventLogEntryType
Uno dei EventLogEntryType valori.
- eventID
- Int32
Identificatore specifico dell'applicazione per l'evento.
- category
- Int16
Sottocategoria specifica dell'applicazione associata al messaggio.
- rawData
- Byte[]
Matrice di byte che contiene i dati binari associati alla voce.
Eccezioni
Il source valore è una stringa vuota ("").
oppure
Il source valore è null.
oppure
eventID è minore di zero o maggiore di UInt16.MaxValue.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
type non è un EventLogEntryTypevalido.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
//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; visualizza solo i dati non elaborati in un formato esadecimale e di testo combinato. Usare con moderazione i dati specifici dell'evento; includerlo solo se si è certi che sarà utile. È anche possibile usare dati specifici dell'evento per archiviare 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.
Annotazioni
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, nel Visualizzatore eventi viene visualizzato 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 eventi visualizzano questi valori stringa per aiutare l'utente a capire cosa è andato storto e suggerire le azioni da intraprendere.
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 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. Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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 IPv6 (Internet Protocol) 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)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi, usando l'origine evento registrata specificata. Può category essere utilizzato dal Visualizzatore eventi per filtrare gli eventi nel 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
Origine in base alla quale l'applicazione viene registrata nel computer specificato.
- message
- String
Stringa da scrivere nel registro eventi.
- type
- EventLogEntryType
Uno dei EventLogEntryType valori.
- eventID
- Int32
Identificatore specifico dell'applicazione per l'evento.
- category
- Int16
Sottocategoria specifica dell'applicazione associata al messaggio.
Eccezioni
Il source valore è una stringa vuota ("").
oppure
Il source valore è null.
oppure
eventID è minore di zero o maggiore di UInt16.MaxValue.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
type non è un EventLogEntryTypevalido.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
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);
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.
Annotazioni
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, nel Visualizzatore eventi viene visualizzato 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 eventi visualizzano questi valori stringa per aiutare l'utente a capire cosa è andato storto e suggerire le azioni da intraprendere.
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 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. Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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 IPv6 (Internet Protocol) 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[])
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi e aggiunge 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 EventLogEntryType valori.
- eventID
- Int32
Identificatore specifico dell'applicazione per l'evento.
- category
- Int16
Sottocategoria specifica dell'applicazione associata al messaggio.
- rawData
- Byte[]
Matrice di byte che contiene i dati binari associati alla voce.
Eccezioni
La Source proprietà di EventLog non è stata impostata.
oppure
Il metodo ha tentato di registrare una nuova origine evento, ma il nome del computer in MachineName non è valido.
oppure
L'origine è già registrata per un registro eventi diverso.
oppure
eventID è minore di zero o maggiore di UInt16.MaxValue.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
type non è un EventLogEntryTypevalido.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
// 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; visualizza solo i dati non elaborati in un formato esadecimale e di testo combinato. Usare con moderazione i dati specifici dell'evento, incluso 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 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.
Annotazioni
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 IPv6 (Internet Protocol) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.
Annotazioni
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, nel Visualizzatore eventi viene visualizzato 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 eventi visualizzano questi valori stringa per aiutare l'utente a capire cosa è andato storto e suggerire le azioni da intraprendere.
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 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.
Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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.
Annotazioni
Se non si specifica un MachineName oggetto per l'istanza EventLog prima di chiamare CreateEventSource o WriteEntry, viene 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.
Annotazioni
Molte eccezioni elencate in precedenza 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 e non usa un file di risorse del messaggio localizzabile. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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.
Annotazioni
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, String, EventLogEntryType, Int32)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce con il testo del messaggio specificato e l'identificatore dell'evento definito dall'applicazione nel registro eventi, usando l'origine evento 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 in base alla quale l'applicazione viene registrata nel computer specificato.
- message
- String
Stringa da scrivere nel registro eventi.
- type
- EventLogEntryType
Uno dei EventLogEntryType valori.
- eventID
- Int32
Identificatore specifico dell'applicazione per l'evento.
Eccezioni
Il source valore è una stringa vuota ("").
oppure
Il source valore è null.
oppure
eventID è minore di zero o maggiore di UInt16.MaxValue.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
type non è un EventLogEntryTypevalido.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
// 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 eseguono il mapping. I visualizzatori di eventi presentano queste stringhe all'utente per aiutare l'utente a capire cosa è andato storto e suggerire le azioni da intraprendere.
Annotazioni
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 IPv6 (Internet Protocol) 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 consente di WriteEntry specificare un oggetto EventLogEntryType per l'evento scritto nel registro eventi. L'oggetto type è indicato da un'icona e 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. Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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, Int16)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce con il testo del messaggio specificato, l'identificatore di evento definito dall'applicazione e la categoria definita dall'applicazione nel registro eventi.
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 EventLogEntryType valori.
- eventID
- Int32
Identificatore specifico dell'applicazione per l'evento.
- category
- Int16
Sottocategoria specifica dell'applicazione associata al messaggio.
Eccezioni
La Source proprietà di EventLog non è stata impostata.
oppure
Il metodo ha tentato di registrare una nuova origine evento, ma il nome del computer in MachineName non è valido.
oppure
L'origine è già registrata per un registro eventi diverso.
oppure
eventID è minore di zero o maggiore di UInt16.MaxValue.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
type non è un EventLogEntryTypevalido.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
// 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.
Annotazioni
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.
Annotazioni
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 IPv6 (Internet Protocol) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.
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, nel Visualizzatore eventi viene visualizzato 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 eventi visualizzano questi valori stringa per aiutare l'utente a capire cosa è andato storto e suggerire le azioni da intraprendere.
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 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.
Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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.
Annotazioni
Se non si specifica un MachineName oggetto per l'istanza EventLog prima di chiamare CreateEventSource o WriteEntry, viene 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.
Annotazioni
Molte eccezioni elencate in precedenza 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 e non usa un file di risorse del messaggio localizzabile. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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.
Annotazioni
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)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce di controllo di errore, avviso, informazioni, controllo riuscito o errore con il testo del messaggio specificato nel registro eventi.
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 EventLogEntryType valori.
Eccezioni
La Source proprietà di EventLog non è stata impostata.
oppure
Il metodo ha tentato di registrare una nuova origine evento, ma il nome del computer in MachineName non è valido.
oppure
L'origine è già registrata per un registro eventi diverso.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
type non è un EventLogEntryTypevalido.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
L'esempio seguente scrive una voce di avviso in un registro eventi, "MyNewLog", nel computer locale.
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 un testo nella colonna Tipo nel Visualizzatore eventi per un log.
Annotazioni
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 IPv6 (Internet Protocol) 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.
Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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.
Annotazioni
Se non si specifica un MachineName oggetto per l'istanza EventLog prima di chiamare CreateEventSource o WriteEntry, viene 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.
Annotazioni
Molte eccezioni elencate in precedenza 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 e non usa un file di risorse del messaggio localizzabile. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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.
Annotazioni
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)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce con il testo del messaggio specificato e l'identificatore dell'evento definito dall'applicazione nel registro eventi.
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 EventLogEntryType valori.
- eventID
- Int32
Identificatore specifico dell'applicazione per l'evento.
Eccezioni
La Source proprietà di EventLog non è stata impostata.
oppure
Il metodo ha tentato di registrare una nuova origine evento, ma il nome del computer in MachineName non è valido.
oppure
L'origine è già registrata per un registro eventi diverso.
oppure
eventID è minore di zero o maggiore di UInt16.MaxValue.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
type non è un EventLogEntryTypevalido.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
// 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 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 eventi visualizzano questi valori stringa per aiutare l'utente a capire cosa è andato storto e suggerire le azioni da intraprendere.
Annotazioni
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 IPv6 (Internet Protocol) 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 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.
Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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.
Annotazioni
Se non si specifica un MachineName oggetto per l'istanza EventLog prima di chiamare CreateEventSource o WriteEntry, viene 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.
Annotazioni
Molte eccezioni elencate in precedenza 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 e non usa un file di risorse del messaggio localizzabile. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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.
Annotazioni
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, String)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce del tipo di informazioni con il testo del messaggio specificato nel registro eventi, utilizzando l'origine evento 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 in base alla quale l'applicazione viene registrata nel computer specificato.
- message
- String
Stringa da scrivere nel registro eventi.
Eccezioni
Il source valore è una stringa vuota ("").
oppure
Il source valore è null.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
L'esempio seguente crea l'origine MySource se non esiste già e scrive una voce nel registro eventi MyNewLog.
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
Utilizzare 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 desidera 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. Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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 IPv6 (Internet Protocol) può contenere questa sequenza di caratteri, non è possibile registrare un messaggio di evento contenente un indirizzo IPv6.
Vedi anche
Si applica a
WriteEntry(String)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive una voce del tipo di informazioni, 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 Source proprietà di EventLog non è stata impostata.
oppure
Il metodo ha tentato di registrare una nuova origine evento, ma il nome del computer in MachineName non è valido.
oppure
L'origine è già registrata per un registro eventi diverso.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
L'esempio seguente crea l'origine MySource se non esiste già e scrive una voce nel registro eventi MyNewLog.
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
Utilizzare questo metodo per scrivere una voce di informazioni nel registro eventi associato a questa EventLog istanza. Se si desidera specificare qualsiasi altro EventLogEntryType, usare un overload diverso di WriteEntry.
Annotazioni
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 IPv6 (Internet Protocol) 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.
Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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.
Annotazioni
Se non si specifica un MachineName oggetto per l'istanza EventLog prima di chiamare CreateEventSource o WriteEntry, viene 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.
Annotazioni
Molte delle 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. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
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.
Annotazioni
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, String, EventLogEntryType)
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
- Origine:
- EventLog.cs
Scrive un errore, un avviso, informazioni, un controllo di esito positivo o una voce di controllo degli errori con il testo del messaggio specificato nel registro eventi, utilizzando l'origine evento 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 in base alla quale l'applicazione viene registrata nel computer specificato.
- message
- String
Stringa da scrivere nel registro eventi.
- type
- EventLogEntryType
Uno dei EventLogEntryType valori.
Eccezioni
Il source valore è una stringa vuota ("").
oppure
Il source valore è null.
oppure
La stringa del messaggio è più lunga di 31.839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).
oppure
Il nome di origine restituisce un percorso di chiave del Registro di sistema più lungo di 254 caratteri.
Impossibile aprire la chiave del Registro di sistema per il registro eventi.
type non è un EventLogEntryTypevalido.
Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Codice di errore di Windows non disponibile.
Esempio
L'esempio seguente scrive una voce di avviso in un registro eventi, "MyNewLog", nel computer locale.
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
Utilizzare 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 nel Visualizzatore eventi per un log.
Annotazioni
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 IPv6 (Internet Protocol) 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. Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle 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. Utilizzare il WriteEvent metodo per scrivere eventi usando un file di risorse del 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 WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.
Annotazioni
Se il message parametro contiene un carattere NUL, il messaggio nel registro eventi viene terminato in corrispondenza del carattere NUL.