EventLog.DeleteEventSource Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.EventLog.dll

Paquete:

System.Diagnostics.EventLog v8.0.0

Quita del registro de eventos un registro del origen de eventos de una aplicación.

Sobrecargas

DeleteEventSource(String)	Quita del registro de eventos del equipo local el registro del origen de eventos.
DeleteEventSource(String, String)	Quita del equipo especificado el registro del origen de eventos de la aplicación.

DeleteEventSource(String)

Source:

EventLog.cs

Quita del registro de eventos del equipo local el registro del origen de eventos.

public:
 static void DeleteEventSource(System::String ^ source);

public static void DeleteEventSource (string source);

static member DeleteEventSource : string -> unit

Public Shared Sub DeleteEventSource (source As String)

Parámetros

source

String

Nombre con el que se registra la aplicación en el sistema de registro de eventos.

Excepciones

ArgumentException

El parámetro source no existe en el Registro del equipo local.

o bien

No se dispone de acceso de escritura en la clave del Registro para el registro de eventos.

Ejemplos

En el ejemplo siguiente se elimina un origen del equipo local. En el ejemplo se determina el registro de su origen y, a continuación, se elimina el registro.

Nota

Es posible que más de un origen escriba en un registro de eventos. Antes de eliminar un registro personalizado, asegúrese de que no haya otros orígenes que escriban en ese registro.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   String^ logName;
   if ( EventLog::SourceExists( "MySource" ) )
   {
      
      // Find the log associated with this source.    
      logName = EventLog::LogNameFromSourceName( "MySource", "." );
      // Make sure the source is in the log we believe it to be in
      if (logName != "MyLog")
          return -1;
      // Delete the source and the log.
      EventLog::DeleteEventSource( "MySource" );
      EventLog::Delete( logName );
      Console::WriteLine( "{0} deleted.", logName );
   }
   else
        {
            // Create the event source to make next try successful.
            EventLog::CreateEventSource("MySource", "MyLog");
        }
}

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

class MySample1
{
    public static void Main()
    {
        string logName;

        if (EventLog.SourceExists("MySource"))
        {
            // Find the log associated with this source.
            logName = EventLog.LogNameFromSourceName("MySource", ".");
            // Make sure the source is in the log we believe it to be in.
            if (logName != "MyLog")
                return;
            // Delete the source and the log.
            EventLog.DeleteEventSource("MySource");
            EventLog.Delete(logName);

            Console.WriteLine(logName + " deleted.");
        }
        else
        {
            // Create the event source to make next try successful.
            EventLog.CreateEventSource("MySource", "MyLog");
        }
    }
}

Option Explicit On
Option Strict On

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        Dim logName As String

        If EventLog.SourceExists("MySource") Then
            ' Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MySource", ".")
            ' Make sure the source is in the log we believe it to be in
            If (logName <> "MyLog") Then
                Return
            End If
            ' Delete the source and the log.
            EventLog.DeleteEventSource("MySource")
            EventLog.Delete(logName)

            Console.WriteLine((logName & " deleted."))
        Else
            ' Create the event source to make next try successful.
            EventLog.CreateEventSource("MySource", "MyLog")
        End If
    End Sub
End Class

Comentarios

Use este método para quitar el registro de un Source elemento del equipo local. DeleteEventSource accede al Registro en el equipo local y quita el registro de la aplicación como origen válido de eventos.

Puede quitar el componente como un origen de eventos válido si ya no lo necesita para escribir entradas en ese registro. Por ejemplo, puede hacerlo si necesita cambiar el componente de un registro a otro. Dado que un origen solo se puede registrar en un registro cada vez, cambiar el registro requiere que quite el registro actual.

DeleteEventSource quita solo el origen registrado en un registro. Si desea quitar el propio registro, llame a Delete. Si solo desea eliminar las entradas de registro, llame a Clear. Delete y DeleteEventSource son static métodos, por lo que se puede llamar a en la propia clase. No es necesario crear una instancia de para llamar a ninguno de EventLog los métodos.

Al eliminar un registro a través de una llamada para Delete eliminar automáticamente los orígenes registrados en ese registro. Esto puede hacer que otras aplicaciones usen ese registro inoperativo.

Nota

Si ya se ha asignado un origen a un registro y se vuelve a asignar a un nuevo registro, debe reiniciar el equipo para que los cambios surtan efecto.

Consulte también

• CreateEventSource
• Source
• SourceExists(String)
• Delete(String)
• Clear()

DeleteEventSource(String, String)

Source:

EventLog.cs

Quita del equipo especificado el registro del origen de eventos de la aplicación.

public:
 static void DeleteEventSource(System::String ^ source, System::String ^ machineName);

public static void DeleteEventSource (string source, string machineName);

static member DeleteEventSource : string * string -> unit

Public Shared Sub DeleteEventSource (source As String, machineName As String)

Parámetros

source

String

Nombre con el que se registra la aplicación en el sistema de registro de eventos.

machineName

String

Nombre del equipo del que hay que quitar el registro o "." para el equipo local.

Excepciones

ArgumentException

El parámetro machineName no es válido.

o bien

El parámetro source no existe en el Registro del equipo especificado.

o bien

No se dispone de acceso de escritura en la clave del Registro para el registro de eventos.

InvalidOperationException

No se puede eliminar source porque en el Registro, la clave del Registro primaria para source no contiene una subclave con el mismo nombre.

Ejemplos

En el ejemplo siguiente se elimina un origen del equipo especificado. En el ejemplo se determina el registro de su origen y, a continuación, se elimina el registro.

Nota

Es posible que más de un origen escriba en un registro de eventos. Antes de eliminar un registro personalizado, asegúrese de que no haya otros orígenes que escriban en ese registro.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   String^ logName;
   if ( EventLog::SourceExists( "MySource", "MyMachine") )
   {
      
      // Find the log associated with this source.    
      logName = EventLog::LogNameFromSourceName( "MySource", "MyMachine" );
      // Make sure the source is in the log we believe it to be in
      if (logName != "MyLog")
          return -1;
      // Delete the source and the log.
      EventLog::DeleteEventSource( "MySource", "MyMachine" );
      EventLog::Delete( logName, "MyMachine" );
      Console::WriteLine( "{0} deleted.", logName );
   }
   else
        {
            // Create the event source to make next try successful.
            EventSourceCreationData^ mySourceData = gcnew EventSourceCreationData("MySource", "MyLog");
            mySourceData->MachineName = "MyMachine";
            EventLog::CreateEventSource(mySourceData);
        }
}

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

class MySample
{
    public static void Main()
    {
        string logName;

        if (EventLog.SourceExists("MySource", "MyMachine"))
        {
            // Find the log associated with this source.
            logName = EventLog.LogNameFromSourceName("MySource", "MyMachine");
            // Make sure the source is in the log we believe it to be in.
            if (logName != "MyLog")
                return;
            // Delete the source and the log.
            EventLog.DeleteEventSource("MySource", "MyMachine");
            EventLog.Delete(logName, "MyMachine");

            Console.WriteLine(logName + " deleted.");
        }
        else
        {
            // Create the event source to make next try successful.
            EventSourceCreationData mySourceData = new EventSourceCreationData("MySource", "MyLog");
            mySourceData.MachineName = "MyMachine";
            EventLog.CreateEventSource(mySourceData);
        }
    }
}

Option Explicit On
Option Strict On

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        Dim logName As String

        If EventLog.SourceExists("MySource", "MyMachine") Then
            ' Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MySource", "MyMachine")
            ' Make sure the source is in the log we believe it to be in
            If (logName <> "MyLog") Then
                Return
            End If
            ' Delete the source and the log.
            EventLog.DeleteEventSource("MySource", "MyMachine")
            EventLog.Delete(logName, "MyMachine")

            Console.WriteLine((logName & " deleted."))
        Else
            ' Create the event source to make next try successful.
            Dim mySourceData As New EventSourceCreationData("MySource", "MyLog")
            mySourceData.MachineName = "MyMachine"
            EventLog.CreateEventSource(mySourceData)
        End If
    End Sub
End Class

Comentarios

Use esta sobrecarga para quitar el registro de un Source desde un equipo remoto. DeleteEventSource obtiene acceso al Registro en el equipo especificado por machineName y quita el registro de la aplicación como origen válido de eventos.

Puede quitar el componente como un origen de eventos válido si ya no lo necesita para escribir entradas en ese registro. Por ejemplo, puede hacerlo si necesita cambiar el componente de un registro a otro. Dado que un origen solo se puede registrar en un registro cada vez, cambiar el registro requiere que quite el registro actual.

DeleteEventSource quita solo el origen registrado en un registro. Si desea quitar el propio registro, llame a Delete. Si solo desea eliminar las entradas de registro, llame a Clear. Delete y DeleteEventSource son static métodos, por lo que se puede llamar a en la propia clase. No es necesario crear una instancia de para llamar a ninguno de EventLog los métodos.

Al eliminar un registro a través de una llamada para Delete eliminar automáticamente los orígenes registrados en ese registro. Esto puede hacer que otras aplicaciones usen ese registro inoperativo.

Nota

Si ya se ha asignado un origen a un registro y se vuelve a asignar a un nuevo registro, debe reiniciar el equipo para que los cambios surtan efecto.

Consulte también

• CreateEventSource
• Source
• MachineName
• SourceExists(String)
• Delete(String)
• Clear()