EventLog.DeleteEventSource Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paquet:

System.Diagnostics.EventLog v8.0.0

Supprime l'inscription de la source des événements d'une application du journal des événements.

Surcharges

DeleteEventSource(String)	Supprime l'inscription de la source d'événements du journal des événements de l'ordinateur local.
DeleteEventSource(String, String)	Supprime l'inscription de la source d'événements de l'application sur l'ordinateur spécifié.

DeleteEventSource(String)

Source:

EventLog.cs

Supprime l'inscription de la source d'événements du journal des événements de l'ordinateur local.

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)

Paramètres

source

String

Nom d'inscription de l'application dans le système de journal des événements.

Exceptions

ArgumentException

Le paramètre source n'existe pas dans le Registre de l'ordinateur local.

- ou -

Vous n'avez pas accès en écriture à la clé de Registre du journal des événements.

Exemples

L’exemple suivant supprime une source de l’ordinateur local. L’exemple détermine le journal à partir de sa source, puis supprime le journal.

Notes

Plusieurs sources peuvent écrire dans un journal des événements. Avant de supprimer un journal personnalisé, vérifiez qu’aucune autre source n’écrit dans ce journal.

#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

Remarques

Utilisez cette méthode pour supprimer l’inscription d’un Source de l’ordinateur local. DeleteEventSource accède au Registre sur l’ordinateur local et supprime l’inscription de votre application en tant que source d’événements valide.

Vous pouvez supprimer votre composant en tant que source d’événements valide si vous n’en avez plus besoin pour écrire des entrées dans ce journal. Par exemple, vous pouvez effectuer cette opération si vous devez changer votre composant d’un journal à un autre. Étant donné qu’une source ne peut être inscrite que dans un seul journal à la fois, la modification du journal vous oblige à supprimer l’inscription actuelle.

DeleteEventSource supprime uniquement la source inscrite dans un journal. Si vous souhaitez supprimer le journal lui-même, appelez Delete. Si vous souhaitez uniquement supprimer les entrées de journal, appelez Clear. Delete et DeleteEventSource sont static des méthodes, de sorte qu’elles peuvent être appelées sur la classe elle-même. Il n’est pas nécessaire de créer une instance de pour appeler l’une ou l’autre EventLog méthode.

La suppression d’un journal par le biais d’un appel supprime Delete automatiquement les sources inscrites dans ce journal. Cela peut rendre d’autres applications qui utilisent ce journal inopérante.

Notes

Si une source a déjà été mappée à un journal et que vous la remapncez dans un nouveau journal, vous devez redémarrer l’ordinateur pour que les modifications prennent effet.

Voir aussi

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

DeleteEventSource(String, String)

Source:

EventLog.cs

Supprime l'inscription de la source d'événements de l'application sur l'ordinateur spécifié.

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)

Paramètres

source

String

Nom d'inscription de l'application dans le système de journal des événements.

machineName

String

Nom de l'ordinateur d'où l'inscription doit être supprimée ou "." pour l'ordinateur local.

Exceptions

ArgumentException

Le paramètre machineName n'est pas valide.

- ou -

Le paramètre source n'existe pas dans le Registre de l'ordinateur spécifié.

- ou -

Vous n'avez pas accès en écriture à la clé de Registre du journal des événements.

InvalidOperationException

source ne peut pas être supprimé car, dans le Registre, la clé de Registre parente pour sourcene contient pas de sous-clé du même nom.

Exemples

L’exemple suivant supprime une source de l’ordinateur spécifié. L’exemple détermine le journal à partir de sa source, puis supprime le journal.

Notes

Plusieurs sources peuvent écrire dans un journal des événements. Avant de supprimer un journal personnalisé, vérifiez qu’aucune autre source n’écrit dans ce journal.

#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

Remarques

Utilisez cette surcharge pour supprimer l’inscription d’un Source à partir d’un ordinateur distant. DeleteEventSource accède au Registre sur l’ordinateur spécifié par machineName et supprime l’inscription de votre application en tant que source d’événements valide.

Vous pouvez supprimer votre composant en tant que source d’événements valide si vous n’en avez plus besoin pour écrire des entrées dans ce journal. Par exemple, vous pouvez effectuer cette opération si vous devez changer votre composant d’un journal à un autre. Étant donné qu’une source ne peut être inscrite que dans un seul journal à la fois, la modification du journal vous oblige à supprimer l’inscription actuelle.

DeleteEventSource supprime uniquement la source inscrite dans un journal. Si vous souhaitez supprimer le journal lui-même, appelez Delete. Si vous souhaitez uniquement supprimer les entrées de journal, appelez Clear. Delete et DeleteEventSource sont static des méthodes, de sorte qu’elles peuvent être appelées sur la classe elle-même. Il n’est pas nécessaire de créer une instance de pour appeler l’une ou l’autre EventLog méthode.

La suppression d’un journal par le biais d’un appel supprime Delete automatiquement les sources inscrites dans ce journal. Cela peut rendre d’autres applications qui utilisent ce journal inopérante.

Notes

Si une source a déjà été mappée à un journal et que vous la remapncez dans un nouveau journal, vous devez redémarrer l’ordinateur pour que les modifications prennent effet.

Voir aussi

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