Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo EventLog.WriteEntry (String, EventLogEntryType)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Diagnostics
Assembly:  System (in System.dll)

public void WriteEntry(
	string message,
	EventLogEntryType type
)

Parametri

message
Type: System.String

Stringa da scrivere nel registro eventi.

type
Type: System.Diagnostics.EventLogEntryType

Uno dei valori di EventLogEntryType.

Exception Condition
ArgumentException

Il Source di 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à registrato per un registro eventi diverso.

-oppure-

La stringa di messaggio è supera a 31,839 byte (32.766 byte nei sistemi operativi Windows prima di Windows Vista).

-oppure-

I risultati di nome di origine in un percorso della chiave del Registro di sistema più lungo di 254 caratteri.

InvalidEnumArgumentException

type non è un oggetto EventLogEntryType valido.

InvalidOperationException

Impossibile aprire la chiave del Registro di sistema per il registro eventi.

Win32Exception

Il sistema operativo ha segnalato un errore durante la scrittura della voce dell'evento nel registro eventi. Un codice di errore di Windows non è disponibile.

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

System_CAPS_noteNota

Il message stringa non può contenere %n, dove n è un valore intero (ad esempio, %1), perché il Visualizzatore eventi considera una stringa di inserimento. Poiché un protocollo Internet versione 6 (IPv6) indirizzo può contenere questa sequenza di caratteri, non è possibile accedere un messaggio di evento che contiene un indirizzo IPv6.

È necessario impostare il Source proprietà di 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 eventi durante l'installazione dell'applicazione. Questo consente di tempo per il sistema operativo aggiornare l'elenco delle origini eventi registrati e la relativa configurazione. Se il sistema operativo non è aggiornato l'elenco delle origini evento e si tenta di scrivere un evento con la nuova origine, che l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine mediante un EventLogInstaller, o tramite il CreateEventSource metodo. È necessario disporre dei diritti amministrativi sul computer per creare una nuova origine evento.

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

System_CAPS_noteNota

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

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

System_CAPS_noteNota

Molte eccezioni elencate in precedenza sono 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 il registro eventi, non viene utilizzato un file di risorse messaggio localizzabile. Utilizzare il WriteEvent metodo per scrivere eventi utilizzando un file di risorse messaggio localizzato.

Se l'applicazione scrive voci tramite identificatori di risorsa e i valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine dei file di risorse e quindi utilizzare tale origine nel WriteEvent metodo per scrivere voci tramite identificatori di risorsa nel registro eventi. Quindi creare un'origine diversa senza file di risorse e utilizzarla nel WriteEntry metodo per scrivere stringhe direttamente nel log eventi.

System_CAPS_noteNota

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 è in esecuzione .NET Framework.

System_CAPS_noteNota

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

Nell'esempio seguente viene registrata una voce di avviso per un log eventi "MyNewLog", nel computer locale.

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

class MySample{

    public static void Main(){


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

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

    }
}

EventLogPermission

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

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: