EventLog.Source Proprietà

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.SettingsBindable(true)]
public string Source { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.SettingsBindable(true)]
public string Source { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
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 ("").

Attributi

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

Nell'esempio seguente viene creata la MySource di origine, 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.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
End Class

Commenti

L'origine evento indica il registro dell'evento.The event source indicates what logs the event. È spesso il nome dell'applicazione o il nome di un 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 i servizi devono scrivere nel registro applicazioni o in 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.

È necessario specificare un'origine evento solo se si sta scrivendo in un registro eventi.You only need to specify an event source if you are writing to an event log. Prima di scrivere una voce in un registro eventi, è necessario registrare l'origine eventi 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 usa la proprietà Source per 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 Sourceo una 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, viene utilizzato il computer locale (".").If you do not specify the MachineName, the local computer (".") is assumed.

Utilizzare WriteEvent e WriteEntry per scrivere eventi in un registro eventi.Use WriteEvent and WriteEntry to write events to an event log. È necessario specificare un'origine evento per la scrittura di 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. Ciò consente al sistema operativo di aggiornare l'elenco delle origini eventi registrate 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 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.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 utilizzando un EventLogInstallero utilizzando il metodo CreateEventSource.You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.You must have administrative rights on the computer to create a new event source.

È possibile creare un'origine evento per un registro eventi esistente o per 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 per tale log, ma il log non viene creato fino a quando non viene scritta la prima voce.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 univoca nel computer locale. un nuovo nome di origine non può corrispondere a un nome di origine esistente o a un nome di registro 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 in un solo log eventi alla volta. Tuttavia, l'applicazione può usare più origini per scrivere in 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 i diversi registri 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 valore di Source, l'EventLog a cui è registrata viene chiuso 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 configurata 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 voci usando sia gli identificatori di risorsa che i valori di stringa, è necessario registrare due origini separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel metodo WriteEvent 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. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo WriteEntry per scrivere le stringhe direttamente nel 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 crearla 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 anziché eliminare l'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 è già stato eseguito il mapping di un'origine a un log e si esegue il mapping a un nuovo log, è necessario riavviare il computer per 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.

Si applica a

Vedi anche