EventLog.DeleteEventSource Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Balíček:

System.Diagnostics.EventLog v11.0.0-preview.5.26302.115

Odebere registraci zdroje událostí aplikace z protokolu událostí.

Přetížení

Name	Description
DeleteEventSource(String)	Odebere registraci zdroje událostí z protokolu událostí místního počítače.
DeleteEventSource(String, String)	Odebere registraci zdroje událostí aplikace ze zadaného počítače.

DeleteEventSource(String)

Zdroj:

EventLog.cs

Odebere registraci zdroje událostí z protokolu událostí místního počítače.

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)

Parametry

source

String

Název, podle kterého je aplikace zaregistrovaná v systému protokolu událostí.

Výjimky

ArgumentException

Parametr source v registru místního počítače neexistuje.

nebo

Pro protokol událostí nemáte přístup k zápisu do klíče registru.

Příklady

Následující příklad odstraní zdroj z místního počítače. Příklad určuje protokol ze svého zdroje a pak odstraní protokol.

Note

Do protokolu událostí může zapisovat více zdrojů. Před odstraněním vlastního protokolu se ujistěte, že do tohoto protokolu nejsou žádné další zdroje.

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

Poznámky

Tuto metodu použijte k odebrání registrace z Source místního počítače. DeleteEventSource přistupuje k registru v místním počítači a odebere registraci aplikace jako platný zdroj událostí.

Komponentu můžete odebrat jako platný zdroj událostí, pokud už ji nepotřebujete k zápisu položek do tohoto protokolu. Můžete to udělat například v případě, že potřebujete změnit komponentu z jednoho protokolu na jiný. Vzhledem k tomu, že zdroj je možné zaregistrovat pouze do jednoho protokolu najednou, vyžaduje změna protokolu odebrání aktuální registrace.

DeleteEventSource odebere pouze zdroj zaregistrovaný v protokolu. Pokud chcete odebrat samotný protokol, zavolejte Delete. Pokud chcete odstranit pouze položky protokolu, zavolejte Clear. Delete a DeleteEventSource jsou static metody, takže je lze volat na samotnou třídu. Není nutné vytvořit instanci EventLog volání jedné z metod.

Odstraněním protokolu prostřednictvím volání Delete se automaticky odstraní zdroje zaregistrované v protokolu. To může usnadnit používání jiných aplikací, které protokolují.

Note

Pokud už byl zdroj namapován na protokol a znovu ho namapujete na nový protokol, je nutné restartovat počítač, aby se změny projevily.

Viz také

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

DeleteEventSource(String, String)

Zdroj:

EventLog.cs

Odebere registraci zdroje událostí aplikace ze zadaného počítače.

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)

Parametry

source

String

Název, podle kterého je aplikace zaregistrovaná v systému protokolu událostí.

machineName

String

Název počítače, ze který chcete odebrat registraci, nebo ". pro místní počítač.

Výjimky

ArgumentException

Parametr machineName je neplatný.

nebo

Parametr source v registru zadaného počítače neexistuje.

nebo

Pro protokol událostí nemáte přístup k zápisu do klíče registru.

InvalidOperationException

source nelze odstranit, protože v registru nadřazený klíč source registru neobsahuje podklíč se stejným názvem.

Příklady

Následující příklad odstraní zdroj ze zadaného počítače. Příklad určuje protokol ze svého zdroje a pak odstraní protokol.

Note

Do protokolu událostí může zapisovat více zdrojů. Před odstraněním vlastního protokolu se ujistěte, že do tohoto protokolu nejsou žádné další zdroje.

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

Poznámky

Toto přetížení použijte k odebrání registrace ze Source vzdáleného počítače. DeleteEventSource přistupuje k registru v počítači určeném uživatelem machineName a odebere registraci aplikace jako platný zdroj událostí.

Komponentu můžete odebrat jako platný zdroj událostí, pokud už ji nepotřebujete k zápisu položek do tohoto protokolu. Můžete to udělat například v případě, že potřebujete změnit komponentu z jednoho protokolu na jiný. Vzhledem k tomu, že zdroj je možné zaregistrovat pouze do jednoho protokolu najednou, vyžaduje změna protokolu odebrání aktuální registrace.

DeleteEventSource odebere pouze zdroj zaregistrovaný v protokolu. Pokud chcete odebrat samotný protokol, zavolejte Delete. Pokud chcete odstranit pouze položky protokolu, zavolejte Clear. Delete a DeleteEventSource jsou static metody, takže je lze volat na samotnou třídu. Není nutné vytvořit instanci EventLog volání jedné z metod.

Odstraněním protokolu prostřednictvím volání Delete se automaticky odstraní zdroje zaregistrované v protokolu. To může usnadnit používání jiných aplikací, které protokolují.

Note

Pokud už byl zdroj namapován na protokol a znovu ho namapujete na nový protokol, je nutné restartovat počítač, aby se změny projevily.

Viz také

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