Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

EventLog.WriteEntry (Método) (String, String, EventLogEntryType)

Escribe en el registro de eventos una entrada de error, advertencia, información, auditoría correcta o auditoría incorrecta con el texto de mensaje dado mediante el origen de eventos registrado especificado.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)
public static void WriteEntry(
	string source,
	string message,
	EventLogEntryType type
)

Parámetros

source
Tipo: System.String
Origen mediante el que se registra la aplicación en el equipo especificado.
message
Tipo: System.String
Cadena que se va a escribir en el registro de eventos.
type
Tipo: System.Diagnostics.EventLogEntryType
Uno de los valores de EventLogEntryType.
ExcepciónCondición
ArgumentException

El valor de source es una cadena vacía ("").

-O bien-

El valor de source es null.

-O bien-

La cadena de mensaje es más de 31.839 bytes (32.766 bytes en los sistemas operativos Windows anterior a Windows Vista).

-O bien-

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

InvalidOperationException

No se ha podido abrir la clave del Registro para el registro de eventos.

InvalidEnumArgumentException

type no es un EventLogEntryType válido.

Win32Exception

El sistema operativo ha notificado un error al escribir la entrada de evento en el registro. No hay ningún código de error de Windows disponible.

Utilice este método para escribir una entrada de un objeto EventLogEntryType especificado en el registro de eventos mediante un origen ya registrado como un origen de eventos para el registro adecuado. El parámetro type se indica mediante un icono y un texto en la columna Tipo del Visor de eventos de un registro.

NotaNota

La cadena message no puede contener %n, donde n es un valor entero (por ejemplo, %1), porque el visor de eventos lo trata como una cadena de inserción. Dado que una dirección de Protocolo de Internet, versión 6 (IPv6) puede contener esta secuencia de caracteres, no se puede registrar ningún mensaje de evento que contenga una dirección IPv6.

El origen de eventos deberá crearse y configurarse antes de escribir la primera entrada con él. El nuevo origen de eventos deberá crearse durante la instalación de la aplicación. Esto permite al sistema operativo actualizar con tiempo la lista de orígenes de eventos registrados y su configuración. 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 en 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.

El origen deberá configurarse para escribir o bien entradas adaptadas o bien cadenas directas. El método WriteEntry escribe la cadena especificada directamente en el registro de eventos, no utiliza un archivo de recursos de mensajes adaptado. Para escribir eventos mediante archivo de recursos de mensajes adaptado, deberá utilizarse el método WriteEvent.

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.

NotaNota

Si el parámetro message contiene un carácter NULL, el mensaje en el registro de eventos se finaliza en el carácter NULL.

En el siguiente ejemplo se escribe una entrada de advertencia en un registro de eventos, "myNewLog", en el equipo local.


using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){


        // Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", 
			"Writing warning to event log.", 
			EventLogEntryType.Warning);

    }
}
      


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.