EventLog.Log EventLog.Log EventLog.Log EventLog.Log Property

Definición

Obtiene o establece el nombre del registro del que se lee o en el que se escribe.Gets or sets the name of the log to read from or write to.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }
member this.Log : string with get, set
Public Property Log As String

Valor de propiedad

Nombre del registro.The name of the log. Puede ser Aplicación, Sistema, Seguridad o el nombre de un registro personalizado.This can be Application, System, Security, or a custom log name. El valor predeterminado es una cadena vacía ("").The default is an empty string ("").

Ejemplos

En el ejemplo siguiente se leen entradas en el registro de eventos, "NewEventLog", en el equipo local.The following example reads entries in the event log, "NewEventLog", on the local computer.

#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
Imports System.Diagnostics
Imports Microsoft.VisualBasic

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 'Main
End Class 'MySample

Comentarios

Existen tres archivos de registro de forma predeterminada en el servidor: Aplicación, sistema y seguridad.Three log files exist by default on the server: Application, System, and Security. Las aplicaciones y los servicios usan el archivo de registro de la aplicación.Applications and services use the Application log file. Los controladores de dispositivo usan el archivo de registro del sistema.Device drivers use the System log file. El sistema genera eventos de auditoría correctos y erróneos en el registro de seguridad cuando la auditoría está activada.The system generates success and failure audit events in the Security log when auditing is turned on. Si tiene otras aplicaciones instaladas, como Active Directory en servidores de Windows, es posible que haya otros archivos de registro predeterminados.If you have other applications installed, like Active Directory on Windows servers, there might be other default log files. Además, puede crear archivos de registro personalizados en un equipo local o remoto.In addition, you can create custom log files on a local or remote computer. 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 aplicaciones predeterminado.Custom logs help organize your entries in a more detailed way than is allowed when your components write events to the default Application log.

Nota

Los nombres de registro están limitados a ocho caracteres.Log names are limited to eight characters. Según el sistema, MyLogSample1 y MyLogSample2 son el mismo registro.According to the system, MyLogSample1 and MyLogSample2 are the same log.

Si escribe en un registro de eventos, no basta con especificar la Log propiedad.If you write to an event log, it is not enough to specify the Log property. Debe asociar una Source propiedad con el recurso de registro de eventos para conectarse a un registro determinado.You must associate a Source property with your event log resource to connect it to a particular log. No es necesario especificar un Source cuando solo se lee de un registro, pero se debe asociar un origen de eventos con el recurso de registro de eventos en el registro del servidor.It is not necessary to specify a Source when only reading from a log, but an event source must be associated with the event log resource in the server's registry. Solo puede especificar el Log nombre y MachineName (el nombre del equipo servidor) para que lo lea.You can specify only the Log name and MachineName (server computer name) to read from it.

Nota

No es necesario especificar el MachineName si se está conectando a un registro.You are not required to specify the MachineName if you are connecting to a log. Si no especifica MachineName, se asume el equipo local (".").If you do not specify the MachineName, the local computer (".") is assumed.

Si no Source se ha especificado la 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).If the Source property has not been specified, a call to Log returns an empty string if Log has not been explicitly set (by setting the Log property, or through the constructor). Si se ha especificado, Log devuelve el nombre del registro en el que se registró el origen. SourceIf the Source has been specified, Log returns the name of the log to which that source was registered.

Un origen solo se puede registrar en un registro a la vez.A source can only be registered to one log at a time. Si la Source propiedad se estableció para una instancia de EventLog, no se puede cambiar Log la propiedad de EventLog ese sin cambiar el valor Source de o DeleteEventSource llamar primero a.If the Source property was set for an instance of EventLog, you cannot change the Log property for that EventLog without changing the value of Source or calling DeleteEventSource first. Si cambia la Log propiedad después de que Source se haya establecido la propiedad, la escritura de una entrada de registro produce una excepción.If you change the Log property after the Source property has been set, writing a log entry throws an exception.

El sistema operativo almacena los registros de eventos como archivos.The operating system stores event logs as files. Al utilizar EventLogInstaller o CreateEventSource para crear un nuevo registro de eventos, el archivo asociado se almacena en el directorio%SystemRoot%\System32\Config del equipo especificado.When you use EventLogInstaller or CreateEventSource to create a new event log, the associated file is stored in the %SystemRoot%\System32\Config directory on the specified computer. El nombre de archivo se establece anexando los 8 primeros caracteres de la Log propiedad con la extensión de nombre de archivo ". evt".The file name is set by appending the first 8 characters of the Log property with the ".evt" file name extension.

No se puede crear un nuevo registro mediante Log la propiedad solo (sin especificar un origen para el registro).You cannot create a new log using the Log property alone (without specifying a source for the log). Puede llamar CreateEventSourcea, pasando un nuevo nombre de registro como parámetro y, a continuación, DeleteEventSourcellamar a.You can call CreateEventSource, passing in a new log name as a parameter, and then call DeleteEventSource. Sin embargo, el intento suele ser crear (y escribir entradas en) nuevos registros específicos de la aplicación o leer los registros existentes.However, the intent is usually either to create (and write entries to) new application-specific logs, or to read from existing logs.

Si el Log valor cambia, se cierra el registro de eventos y se liberan todos los identificadores de eventos.If the Log value changes, the event log is closed and all event handles are released.

Precaución

Si establece la Log propiedad en el nombre de un registro que no existe, el sistema adjunta el EventLog al registro de la aplicación, pero no le advierte de que está utilizando un registro que no es el que especificó.If you set the Log property to the name of a log that does not exist, the system attaches the EventLog to the Application log, but does not warn you that it is using a log other than the one you specified.

Seguridad

EventLogPermission
para escribir la información del registro de eventos en el equipo.for writing the event log information on the computer. Enumeración asociada:WriteAssociated enumeration: Write

Se aplica a

Consulte también: