EventLog.DeleteEventSource Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Пакет:

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

Удаляет регистрацию источника событий приложения из журнала событий.

Перегрузки

Имя	Описание
DeleteEventSource(String)	Удаляет регистрацию источника событий из журнала событий локального компьютера.
DeleteEventSource(String, String)	Удаляет регистрацию источника событий приложения с указанного компьютера.

DeleteEventSource(String)

Исходный код:

EventLog.cs

Удаляет регистрацию источника событий из журнала событий локального компьютера.

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)

Параметры

source

String

Имя, по которому приложение зарегистрировано в системе журнала событий.

Исключения

ArgumentException

Параметр source не существует в реестре локального компьютера.

–или–

У вас нет доступа на запись в разделе реестра для журнала событий.

Примеры

В следующем примере удаляется источник с локального компьютера. В примере определяется журнал из источника, а затем удаляется журнал.

Note

Несколько источников могут записываться в журнал событий. Перед удалением пользовательского журнала убедитесь, что в этом журнале нет других источников.

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

Комментарии

Используйте этот метод, чтобы удалить регистрацию с локального Source компьютера. DeleteEventSource обращается к реестру на локальном компьютере и удаляет регистрацию приложения в качестве допустимого источника событий.

Вы можете удалить компонент в качестве допустимого источника событий, если он больше не нужен для записи записей в этот журнал. Например, это можно сделать, если необходимо изменить компонент из одного журнала в другой. Так как источник может быть зарегистрирован только в одном журнале за раз, изменение журнала требует удаления текущей регистрации.

DeleteEventSource Удаляет только источник, зарегистрированный в журнале. Если вы хотите удалить сам журнал, вызовите его Delete. Если требуется удалить только записи журнала, вызовите.Clear Delete и DeleteEventSource являются static методами, поэтому их можно вызывать к самому классу. Для вызова любого метода не требуется создать экземпляр EventLog .

Удаление журнала с помощью вызова Delete для автоматического удаления источников, зарегистрированных в этом журнале. Это может сделать другие приложения с помощью этого журнала inoperative.

Note

Если источник уже сопоставлен с журналом и переназначается в новый журнал, необходимо перезапустить компьютер, чтобы изменения вступили в силу.

См. также раздел

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

DeleteEventSource(String, String)

Исходный код:

EventLog.cs

Удаляет регистрацию источника событий приложения с указанного компьютера.

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)

Параметры

source

String

Имя, по которому приложение зарегистрировано в системе журнала событий.

machineName

String

Имя компьютера для удаления регистрации с локального компьютера или ".".

Исключения

ArgumentException

Недопустимый параметр machineName.

–или–

Параметр source не существует в реестре указанного компьютера.

–или–

У вас нет доступа на запись в разделе реестра для журнала событий.

InvalidOperationException

source невозможно удалить, так как в реестре родительский раздел source реестра не содержит подраздел с тем же именем.

Примеры

В следующем примере удаляется источник с указанного компьютера. В примере определяется журнал из источника, а затем удаляется журнал.

Note

Несколько источников могут записываться в журнал событий. Перед удалением пользовательского журнала убедитесь, что в этом журнале нет других источников.

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

Комментарии

Используйте эту перегрузку для удаления регистрации с удаленного Source компьютера. DeleteEventSource обращается к реестру на компьютере, machineName указанному и удаляет регистрацию приложения в качестве допустимого источника событий.

Вы можете удалить компонент в качестве допустимого источника событий, если он больше не нужен для записи записей в этот журнал. Например, это можно сделать, если необходимо изменить компонент из одного журнала в другой. Так как источник может быть зарегистрирован только в одном журнале за раз, изменение журнала требует удаления текущей регистрации.

DeleteEventSource Удаляет только источник, зарегистрированный в журнале. Если вы хотите удалить сам журнал, вызовите его Delete. Если требуется удалить только записи журнала, вызовите.Clear Delete и DeleteEventSource являются static методами, поэтому их можно вызывать к самому классу. Для вызова любого метода не требуется создать экземпляр EventLog .

Удаление журнала с помощью вызова Delete для автоматического удаления источников, зарегистрированных в этом журнале. Это может сделать другие приложения с помощью этого журнала inoperative.

Note

Если источник уже сопоставлен с журналом и переназначается в новый журнал, необходимо перезапустить компьютер, чтобы изменения вступили в силу.

См. также раздел

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