Source Propiedad
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

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)

<TypeConverterAttribute("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>
<SettingsBindableAttribute(True)>
Public Property Source As String

Valor de propiedad

Type: System.String

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

Exception Condition
ArgumentException

El nombre de origen produce una ruta de clave del registro más de 254 caracteres.

El origen de eventos indica qué registra el evento. Es a menudo el nombre de la aplicación o el nombre de un subcomponente de la aplicación, si la aplicación es grande. Aplicaciones y servicios deben escribir en el registro de aplicación o un registro personalizado. Controladores de dispositivos deben escribir en el registro del sistema.

Sólo debe 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, debe registrar el origen de eventos con el registro de eventos como un origen de eventos válido. Cuando se escribe una entrada de registro, el sistema usa el Source propiedad que se va a buscar el registro adecuado en el que colocar la entrada. Si está leyendo el registro de eventos, puede especificar el Source, o Log y MachineName.

System_CAPS_noteNota

No es necesario especificar el MachineName Si se conecta a un registro en el equipo local. Si no se especifica la MachineName, el equipo local (".") se supone.

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

Crear el nuevo origen de eventos durante la instalación de la aplicación. Esto da tiempo para el sistema operativo actualizar la 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 y se intenta escribir un evento con el nuevo origen, que se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante un 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 registro de eventos. Cuando se crea un nuevo origen para un registro de eventos, el sistema registra el origen para ese registro, pero no se crea el registro hasta que la primera entrada que se escriba en él.

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 puede escribir en un único registro de eventos a la vez; Sin embargo, la aplicación puede utilizar varios orígenes para escribir en varios registros de eventos. Por ejemplo, la aplicación podría requerir configurados para diferentes registros de eventos o archivos de recursos de varios orígenes.

Si cambia la Source valor, el EventLog al que se ha registrado se cierra y se liberan todos los identificadores de evento.

El origen debe configurarse para escribir entradas adaptadas o cadenas directas. Si la aplicación escribe las entradas mediante identificadores de recursos y valores de cadena, debe registrarse dos orígenes diferentes. Por ejemplo, configurar un origen con archivos de recursos y, a continuación, usar 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 usarlo en el WriteEntry método para escribir cadenas directamente en el registro de eventos utilizando ese origen.

Para cambiar los detalles de configuración de un origen existente, debe eliminar el origen y, a continuación, vuelva a crearla con la nueva configuración. Si otras aplicaciones o componentes utilizan el origen existente, crear un nuevo origen con la configuración actualizada en lugar de eliminarlo.

System_CAPS_noteNota

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

En el ejemplo siguiente se crea el origen de MySource Si no existe ya y escribe una entrada en el registro de eventos MyNewLog.

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

EventLogPermission

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

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar:
© 2016 Microsoft