¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Source (Propiedad)

EventLog.Source (Propiedad)

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

Espacio de nombres: System.Diagnostics
Ensamblado: System (en system.dll)

public string Source { get; set; }
/** @property */
public String get_Source ()

/** @property */
public void set_Source (String value)

public function get Source () : String

public function set Source (value : String)

Valor de propiedad

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

Tipo de excepciónCondición

ArgumentException

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

El origen del evento indica qué registra el evento. El evento suele registrar 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 dispositivos deben escribir en el registro del sistema.

Sólo es necesario especificar un origen de eventos si se va a escribir en un registro de eventos. Antes de escribir una entrada en un registro de eventos, se debe registrar el origen de eventos con el registro de eventos como origen de eventos válido. Cuando se escribe una entrada de registro, el sistema utiliza la propiedad Source para buscar el registro adecuado donde agregarla. Si se está leyendo el registro de eventos, se pueden especificar las propiedades Source o Log y MachineName.

NotaNota

No es necesario especificar MachineName para conectarse a un registro del equipo local. Si no se especifica MachineName, se supone que se trata del equipo local (".").

Para escribir eventos en un registro de eventos, deberán utilizarse WriteEvent y WriteEntry. Para escribir eventos, es necesario especificar un origen de eventos; asimismo, antes de escribir la primera entrada con el origen, es necesario crearlo y configurarlo.

El nuevo origen de eventos deberá crearse durante la instalación de la aplicación. De esta manera, el sistema operativo dispondrá de tiempo para actualizar la lista de orígenes de eventos registrados y sus configuraciones. Si el sistema operativo aún no ha actualizado la lista de orígenes de eventos y se intenta escribir un evento con el nuevo origen, se producirá un error de la operación de escritura. Para configurar un nuevo origen, puede utilizarse EventLogInstaller o el método CreateEventSource. Es necesario contar con derechos administrativos en el equipo para crear un nuevo origen de eventos.

Puede crearse un origen de eventos para un registro de eventos ya existente o para uno nuevo. Cuando se crea un origen para un registro de eventos nuevo, el sistema registra el origen para el registro, pero éste no se crea hasta que no se escribe la primera entrada en él.

El origen ha de ser único en el equipo local (un nombre de origen nuevo no puede coincidir con otro anterior o con el de un registro de eventos ya existente). Aunque cada origen sólo puede escribir en un registro de eventos a la vez, la aplicación puede utilizar varios orígenes para escribir en diversos registros. Por ejemplo, una aplicación podría requerir la configuración de varios orígenes para diferentes registros de eventos o archivos de recursos.

Si cambia el valor de Source, el EventLog donde esté registrado se cerrará y se liberarán todos los controladores de eventos.

El origen deberá configurarse para escribir o bien entradas adaptadas o bien cadenas directas. Cuando una aplicación escriba entradas usando tanto identificadores de recursos como valores de cadena, deberán registrarse dos orígenes diferentes. Por ejemplo, puede configurarse un origen con archivos de recursos y usarlo en el método WriteEvent para escribir entradas en el registro de eventos mediante identificadores de recursos. A continuación, puede crearse otro origen sin archivos de recursos y usarlo en el método WriteEntry para escribir cadenas directamente en el registro de eventos.

Para cambiar los detalles de configuración de un origen ya existente, será necesario eliminarlo primero para volver a crearlo con la nueva configuración. Si otras aplicaciones o componentes lo estuvieran utilizando, en lugar de eliminarlo, deberá crearse uno nuevo con la configuración actualizada.

NotaNota

Cuando un origen asignado a un registro vuelve a asignarse a otro registro, es necesario reiniciar el equipo para que los cambios surtan efecto.

TemaUbicación
Cómo: Generar y ejecutar el ejemplo de proveedor de perfilesGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Generar y ejecutar el ejemplo de proveedor de perfilesGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Generar y ejecutar el ejemplo de proveedor de perfilesGenerar aplicaciones Web ASP .NET

En el siguiente ejemplo se crea el origen MySource, si es que aún no existe, y se escribe una entrada en el registro de eventos 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")){
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
        }
                
        // 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.");                                                                        
    }
}
   

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[] args)
    {
        // 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 = new EventLog();
        myLog.set_Source("MySource");

        // Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.");
        Console.WriteLine("Message written to event log.");
    } //main
} //MySample

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft