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

Propiedad EventLog::Log

 

Publicado: octubre de 2016

Obtiene o establece el nombre del registro del que se lee o en el que se escribe.

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

public:
[TypeConverterAttribute("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[SettingsBindableAttribute(true)]
property String^ Log {
	String^ get();
	void set(String^ value);
}

Valor de propiedad

Type: System::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 ("").

Existen tres archivos de registro de forma predeterminada en el servidor: aplicación, sistema y seguridad. Aplicaciones y servicios utilizan el archivo de registro de la aplicación. Controladores de dispositivos utilizan el archivo de registro del sistema. El sistema genera eventos de auditoría de aciertos y errores en el registro de seguridad cuando la auditoría está activada. Si tiene otras aplicaciones instaladas, como Active Directory en Windows Server, puede haber otros archivos de registro de forma predeterminada. Además, puede crear archivos de registro personalizados en un equipo local o remoto. Los registros personalizados ayudan a organizar las entradas de una forma más detallada que se permite cuando los componentes escriben eventos en el registro de aplicación predeterminado.

System_CAPS_noteNota

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

Si se escribe en un registro de eventos, no es suficiente especificar el Log propiedad. Debe asociar un Source propiedad con los recursos del registro de eventos para conectarlo a un registro determinado. No es necesario especificar un Source cuando sólo se lee de un registro, pero un origen de eventos debe asociarse con el recurso de registro de eventos en el registro del servidor. Sólo se puede especificar el Log nombre y MachineName (nombre de equipo del servidor) para leer de él.

System_CAPS_noteNota

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

Si el Source no 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). Si el Source se ha especificado, Log devuelve el nombre del registro que se registró ese origen.

Un origen sólo se puede registrar en un registro a la vez. Si el Source se estableció la propiedad de una instancia de EventLog, no puede cambiar la Log propiedad para que EventLog sin cambiar el valor de Source o llamando a DeleteEventSource primero. Si cambia el Log propiedad después de la Source propiedad se ha establecido, escribir una entrada de registro produce una excepción.

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

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

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

System_CAPS_cautionPrecaución

Si establece la Log propiedad en el nombre de un registro que no existe, el sistema asocia la EventLog en el registro de aplicación, pero no advertirá de que se está utilizando un registro distinto del especificado.

En el ejemplo siguiente se lee las 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 );
   }
}

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: