EventLog.Source EventLog.Source EventLog.Source EventLog.Source Property

Definizione

Ottiene o imposta il nome dell'origine da registrare e usare quando si scrive nel registro eventi.Gets or sets the source name to register and use when writing to the event log.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.SettingsBindable(true)]
public string Source { get; set; }
member this.Source : string with get, set
Public Property Source As String

Valore della proprietà

Nome registrato con il registro eventi come origine delle voci.The name registered with the event log as a source of entries. Il valore predefinito è una stringa vuota ("").The default is an empty string ("").

Eccezioni

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

Esempi

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

#using <System.dll>

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

   
   // 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." );
   Console::WriteLine( "Message written 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;
        }
                
        // 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.");
        
        Console.WriteLine("Message written to event log.");                                                                        
    }
}
   
Option Explicit
Option Strict
Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        ' 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.")
        
        Console.WriteLine("Message written to event log.")
    End Sub ' Main
End Class ' MySample

Commenti

L'origine dell'evento indica ciò che registra l'evento.The event source indicates what logs the event. È spesso il nome dell'applicazione o il nome del sottocomponente dell'applicazione, se l'applicazione è di grandi dimensioni.It is often the name of the application, or the name of a subcomponent of the application, if the application is large. Le applicazioni e servizi devono scrivere nel registro dell'applicazione o un log personalizzato.Applications and services should write to the Application log or a custom log. I driver di dispositivo devono scrivere nel Registro di sistema.Device drivers should write to the System log.

È sufficiente specificare un'origine evento, se si scrive in un log eventi.You only need to specify an event source if you are writing to an event log. Prima di scrivere una voce in un log eventi, è necessario registrare l'origine evento con il registro eventi come origine valida degli eventi.Before writing an entry to an event log, you must register the event source with the event log as a valid source of events. Quando si scrive una voce di log, il sistema utilizza il Source proprietà di cui trovare il log appropriato in cui inserire la voce.When you write a log entry, the system uses the Source property to find the appropriate log in which to place your entry. Se si sta leggendo il registro eventi, è possibile specificare il Source, o un Log e MachineName.If you are reading the event log, you can either specify the Source, or a Log and MachineName.

Nota

Non è necessario specificare il MachineName se ci si connette a un log nel computer locale.You are not required to specify the MachineName if you are connecting to a log on the local computer. Se non si specifica il MachineName, il computer locale (".") verrà utilizzato.If you do not specify the MachineName, the local computer (".") is assumed.

Uso WriteEvent e WriteEntry per scrivere eventi in un log eventi.Use WriteEvent and WriteEntry to write events to an event log. È necessario specificare un'origine eventi per scrivere eventi; è necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.You must specify an event source to write events; you must create and configure the event source before writing the first entry with the source.

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

È possibile creare un'origine evento per un log eventi esistente o un nuovo registro eventi.You can create an event source for an existing event log or a new event log. Quando si crea una nuova origine per un nuovo registro eventi, il sistema registra l'origine di tale log, ma non viene creato il registro fino a quando non viene scritta la prima voce a esso.When you create a new source for a new event log, the system registers the source for that log, but the log is not created until the first entry is written to it.

L'origine deve essere univoco nel computer locale. un nuovo nome di origine non può corrispondere a un nome di origine esistente o un nome di log eventi esistente.The source must be unique on the local computer; a new source name cannot match an existing source name or an existing event log name. Ogni origine può scrivere solo un registro eventi alla volta. Tuttavia, l'applicazione può utilizzare più origini in cui per scrivere più registri eventi.Each source can write to only one event log at a time; however, your application can use multiple sources to write to multiple event logs. Ad esempio, l'applicazione potrebbe richiedere più origini configurate per diversi log eventi o file di risorse diversi.For example, your application might require multiple sources configured for different event logs or different resource files.

Se si modifica il Source valore, il EventLog a cui è registrato viene chiusa e vengono rilasciati tutti gli handle di evento.If you change the Source value, the EventLog to which it is registered is closed and all event handles are released.

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

Per modificare i dettagli di configurazione di un'origine esistente, è necessario eliminare l'origine e quindi crearlo nuovamente con la nuova configurazione.To change the configuration details of an existing source, you must delete the source and then create it with the new configuration. Se altre applicazioni o componenti usano l'origine esistente, creare una nuova origine con la configurazione aggiornata, piuttosto che l'eliminazione dell'origine esistente.If other applications or components use the existing source, create a new source with the updated configuration rather than deleting the existing source.

Nota

Se un'origine è già stata mappata a un log e si riesegue il mapping di un nuovo registro, è necessario riavviare il computer rendere effettive le modifiche.If a source has already been mapped to a log and you remap it to a new log, you must restart the computer for the changes to take effect.

Sicurezza

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

Si applica a

Vedi anche