Exportar (0) Imprimir
Expandir todo

EventLog.WriteEntry (Método) (String)

Escribe una entrada de tipo de información, con un texto de mensaje determinado, en el registro de eventos.

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

public void WriteEntry (
	string message
)
public void WriteEntry (
	String message
)
public function WriteEntry (
	message : String
)
No aplicable.

Parámetros

message

Cadena que se va a escribir en el registro de eventos.

Tipo de excepciónCondición

ArgumentException

Aún no se ha establecido la propiedad Source de EventLog.

O bien

El método ha intentado registrar un origen de eventos nuevo, pero el nombre de equipo de MachineName no es válido.

O bien

El origen ya está registrado para otro registro de eventos.

O bien

La cadena del mensaje tiene más de 32766 bytes.

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.

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 datos en el registro de eventos asociado a esta instancia de EventLog. Si desea especificar cualquier otro objeto EventLogEntryType, utilice una sobrecarga distinta de WriteEntry.

Se debe establecer la propiedad Source en el componente EventLog para poder escribir entradas en el Registro. 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. De esta manera, el sistema operativo dispondrá de tiempo para actualizar la lista de orígenes de eventos registrados y sus configuraciones. 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 de 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.

Si el origen especificado en la propiedad Source de esta instancia de EventLog no está registrado en el equipo donde el componente está escribiendo, WriteEntry llamará a CreateEventSource y registrará el origen.

NotaNota:

Si no se especifica una propiedad MachineName para la instancia de EventLog antes de llamar a CreateEventSource o a WriteEntry, se supone que se trata del equipo local (".")

Si el sistema tuviera que registrar Source mediante una llamada a WriteEntry y la propiedad Log no estuviera establecida en la instancia de EventLog, se usará de manera predeterminada el registro de aplicaciones.

NotaNota:

Los errores que aparecen durante el proceso de registrar Source generan muchas de las excepciones enumeradas anteriormente.

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 se escribe una entrada en un equipo remoto, puede que el valor del mensaje (la cadena de texto) no sea el esperado si el equipo remoto no está ejecutando .NET Framework.

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 crea el origen MySource, si es que aún no existe, y se escribe una entrada en el registro de eventos MyNewLog.

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    public static void Main(){
    
        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }
                
        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";
        
        // Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.");
        
    }
}
   

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[] args)
    {
        // Create the source, if it does not already exist.
        if (!(EventLog.SourceExists("MySource"))) 
        {
            //An event log source should not be created and immediately used.
            //There is a latency time to enable the source, it should be created
            //prior to executing the application that uses the source.
            //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.set_Source("MySource");

        // Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.");
    } //main 
} //MySample

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft