EventLog.Log 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 del registro del que se lee o en el que se escribe.

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

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

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

Public Property Log As String

Valor de propiedad

String

Nombre del registro. Puede ser Aplicación, Sistema, Seguridad o el nombre de un registro personalizado. El valor predeterminado es una cadena vacía ("").

Atributos

SettingsBindableAttribute

Ejemplos

En el ejemplo siguiente se leen entradas en el registro de eventos, "NewEventLog", en el equipo local.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myNewLog = gcnew EventLog;
   myNewLog->Log = "NewEventLog";
   System::Collections::IEnumerator^ myEnum = myNewLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

using System;
using System.Diagnostics;

class MySample{

    public static void Main(){

        EventLog myNewLog = new EventLog();
        myNewLog.Log = "NewEventLog";
        foreach(EventLogEntry entry in myNewLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }
    }
}

Imports System.Diagnostics

Class MySample
    Public Shared Sub Main()
        Dim myNewLog As New EventLog()
        myNewLog.Log = "NewEventLog"
        Dim entry As EventLogEntry
        For Each entry In  myNewLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub
End Class

Comentarios

Existen tres archivos de registro de forma predeterminada en el servidor: Aplicación, Sistema y Seguridad. Las aplicaciones y los servicios usan el archivo de registro de aplicaciones. Los controladores de dispositivo usan el archivo de registro del sistema. El sistema genera eventos de auditoría de éxito y error en el registro de seguridad al activar la auditoría. Si tiene instaladas otras aplicaciones, como Active Directory en servidores Windows, puede haber otros archivos de registro predeterminados. Además, puede crear archivos de registro personalizados en un equipo local o remoto. Los registros personalizados ayudan a organizar las entradas de una manera más detallada de lo que se permite cuando los componentes escriben eventos en el registro de aplicación predeterminado.

Nota

Los nombres de registro están limitados a ocho caracteres. Según el sistema, MyLogSample1 y MyLogSample2 son el mismo registro.

Si escribe en un registro de eventos, no es suficiente especificar la Log propiedad . Debe asociar una Source propiedad con el recurso de registro de eventos para conectarla a un registro determinado. No es necesario especificar un Source objeto al leer solo desde un registro, pero un origen de eventos debe estar asociado al recurso de registro de eventos en el registro del servidor. Solo puede especificar el Log nombre y MachineName (nombre del equipo del servidor) para leerlo.

Nota

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

Si no se ha especificado la Source propiedad , una llamada a Log devuelve una cadena vacía si Log no se ha establecido explícitamente (estableciendo la Log propiedad o a través del constructor). Source Si se ha especificado , Log devuelve el nombre del registro al que se registró ese origen.

Un origen solo se puede registrar en un registro a la vez. Si la Source propiedad se estableció para una instancia de EventLog, no puede cambiar la Log propiedad para eso EventLog sin cambiar el valor de Source ni llamar DeleteEventSource primero. Si cambia la Log propiedad después de establecer la Source propiedad, al escribir una entrada de registro se produce una excepción.

El sistema operativo almacena los registros de eventos como archivos. Cuando se usa EventLogInstaller o CreateEventSource para crear un nuevo registro de eventos, el archivo asociado se almacena en el directorio %SystemRoot%\System32\Config del equipo especificado. El nombre de archivo se establece anexando los primeros 8 caracteres de la Log propiedad con la extensión de nombre de archivo ".evt".

No se puede crear un registro con la Log propiedad sola (sin especificar un origen para el registro). Puede llamar a CreateEventSource, pasando un nuevo nombre de registro como parámetro y, a continuación, llamar a DeleteEventSource. Sin embargo, la intención suele ser crear (y escribir entradas en) nuevos registros específicos de la aplicación o leer de los registros existentes.

Si el Log valor cambia, se cierra el registro de eventos y se liberan todos los identificadores de eventos.

Precaución

Si establece la Log propiedad en el nombre de un registro que no existe, el sistema adjunta al EventLog registro de aplicación, pero no le advierte de que está usando un registro distinto del especificado.

Consulte también

• MachineName
• Source
• Entries
• Exists(String)
• Delete(String)
• CreateEventSource
• EventLogEntryCollection