EventLog.Source Propiedad

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.EventLog.dll

Paquete:

System.Diagnostics.EventLog v8.0.0

Source:

EventLog.cs

Obtiene o establece el nombre de origen que se va a registrar y utilizar al escribir en el registro de eventos.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public string Source { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Source : string with get, set

Public Property Source As String

Valor de propiedad

String

Nombre registrado con el registro de eventos como origen de entradas. El valor predeterminado es una cadena vacía ("").

Atributos

SettingsBindableAttribute

Excepciones

ArgumentException

El nombre de origen produce una ruta de clave del Registro con una longitud superior a 254 caracteres.

Ejemplos

En el ejemplo siguiente se crea el origen MySource si aún no existe y se escribe una entrada en el registro de eventos 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

Comentarios

El origen del evento indica qué registra el evento. A menudo es el nombre de la aplicación o el nombre de un subcomponente de la aplicación, si la aplicación es grande. Las aplicaciones y los servicios deben escribir en el registro de aplicaciones o en un registro personalizado. Los controladores de dispositivo deben escribir en el registro del sistema.

Solo tiene que especificar un origen de eventos si está escribiendo en un registro de eventos. Antes de escribir una entrada en un registro de eventos, debe registrar el origen del evento con el registro de eventos como un origen válido de eventos. Al escribir una entrada de registro, el sistema usa la Source propiedad para buscar el registro adecuado en el que colocar la entrada. Si va a leer el registro de eventos, puede especificar , Sourceo y LogMachineName.

Nota

No es necesario especificar si MachineName se está conectando a un registro en el equipo local. Si no especifica , MachineNamese asume el equipo local (".").

Use WriteEvent y WriteEntry para escribir eventos en un registro de eventos. Debe especificar un origen de eventos para escribir eventos; Debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Create el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y su configuración. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante EventLogInstaller, o mediante el CreateEventSource método . Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

Puede crear un origen de eventos para un registro de eventos existente o un nuevo registro de eventos. Cuando se crea un nuevo origen para un nuevo registro de eventos, el sistema registra el origen de ese registro, pero el registro no se crea hasta que se escribe la primera entrada.

El origen debe ser único en el equipo local; Un nuevo nombre de origen no puede coincidir con un nombre de origen existente o un nombre de registro de eventos existente. Cada origen solo puede escribir en un registro de eventos a la vez; sin embargo, la aplicación puede usar varios orígenes para escribir en varios registros de eventos. Por ejemplo, la aplicación podría requerir varios orígenes configurados para distintos registros de eventos o archivos de recursos diferentes.

Si cambia el Source valor, se cierra el EventLog objeto al que está registrado y se liberan todos los identificadores de eventos.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. Si la aplicación escribe entradas mediante identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y, a continuación, use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree un origen diferente sin archivos de recursos y use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

Para cambiar los detalles de configuración de un origen existente, debe eliminar el origen y, a continuación, crearlo con la nueva configuración. Si otras aplicaciones o componentes usan el origen existente, cree un nuevo origen con la configuración actualizada en lugar de eliminar el origen existente.

Nota

Si ya se ha asignado un origen a un registro y se vuelve a asignar a un nuevo registro, debe reiniciar el equipo para que los cambios surtan efecto.

Consulte también

• Log
• MachineName
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)