EventLog.DeleteEventSource Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- EventLog.cs
- 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 -> unitPublic 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
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
Se aplica a
DeleteEventSource(String, String)
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- 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 -> unitPublic 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
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.
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.
