EventLog.Delete メソッド

リファレンス

定義

名前空間:: System.Diagnostics

アセンブリ:: System.Diagnostics.EventLog.dll

アセンブリ:: System.dll

パッケージ:: System.Diagnostics.EventLog v6.0.0

パッケージ:: System.Diagnostics.EventLog v7.0.0

パッケージ:: System.Diagnostics.EventLog v8.0.0

パッケージ:: System.Diagnostics.EventLog v9.0.0-preview.2.24128.5

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ログリソースを削除します。

オーバーロード

Delete(String, String)	指定したコンピューターからイベントログを削除します。
Delete(String)	ローカルコンピューターからイベントログを削除します。

Delete(String, String)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定したコンピューターからイベントログを削除します。

public:
 static void Delete(System::String ^ logName, System::String ^ machineName);

public static void Delete (string logName, string machineName);

static member Delete : string * string -> unit

Public Shared Sub Delete (logName As String, machineName As String)

パラメーター

logName: String

削除するログの名前。指定できる値は、アプリケーション、セキュリティ、システム、および指定したコンピューター上の任意のカスタムイベントログです。

machineName: String

ログを削除するコンピューターの名前。ローカルコンピューターの場合は "."。

例外

ArgumentException

logName が空の文字列 ("") または null

- または -

machineName が有効なコンピューター名ではありません。

InvalidOperationException

指定したコンピューター上のイベントログのレジストリキーを開けませんでした。

- または -

指定したコンピューター上にログが存在しません。

Win32Exception

イベントログが正常に消去されませんでした。

- または -

ログを開くことができません。 Windows のエラーコードは使用できません。

例

次の例では、指定したコンピューターからログを削除します。この例では、ソースからのログを決定します。

注意

複数のソースがイベントログに書き込む場合があります。カスタムログを削除する前に、そのログに書き込む他のソースがないことを確認してください。

#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

注釈

削除するログがリモートコンピューターにある場合は、このメソッドを使用します。適切なレジストリアクセス許可があれば、コンピューター上の任意のログを削除できます。

Deleteによって指定されたログを、でlogNamemachineName指定されたコンピューターから削除します。ログに登録されているソースのみを削除する場合は、を呼び出します DeleteEventSource。ログエントリのみを削除する場合は、を呼び出します Clear。 Delete と DeleteEventSource は static メソッドであるため、クラス自体で呼び出すことができます。どちらのメソッドも呼び出すためにの EventLog インスタンスを作成する必要はありません。

このメソッドは、ログの内容を保持するファイルを最初に削除します。その後、レジストリにアクセスし、そのログに登録されているすべてのイベントソースを削除します。後でログを再作成する場合は、イベントソースを再利用する場合は、再度登録する必要があります。イベントソースを登録せず、他のユーザーがログ名を指定せずにイベントソースに書き込む場合、イベントソースはアプリケーションイベントログに作成されます。そのため、以前に削除して再作成したログにエントリを書き込めたアプリケーションでは、代わりにアプリケーションログに書き込まれます。これは、イベントソースが含まれるようになったためです。

注意

イベントログの再作成は、困難なプロセスになる可能性があります。アプリケーションログなど、システムによって作成されたイベントログは削除しないでください。

を呼び出してログを Delete 削除すると、そのログに登録されているソースが自動的に削除されます。これにより、そのログを使用する他のアプリケーションが動作不能になる可能性があります。

こちらもご覧ください

適用対象

Delete(String)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ローカルコンピューターからイベントログを削除します。

public:
 static void Delete(System::String ^ logName);

public static void Delete (string logName);

static member Delete : string -> unit

Public Shared Sub Delete (logName As String)

パラメーター

logName: String

削除するログの名前。指定できる値は、アプリケーション、セキュリティ、システム、およびコンピューター上の任意のカスタムイベントログです。

例外

ArgumentException

logName が空の文字列 ("") または null

InvalidOperationException

ローカルコンピューター上のイベントログのレジストリキーを開けませんでした。

- または -

ローカルコンピューター上にログが存在しません。

Win32Exception

イベントログが正常に消去されませんでした。

- または -

ログを開くことができません。 Windows のエラーコードは使用できません。

例

次の例では、ローカルコンピューターからログを削除します。この例では、ソースからのログを決定します。

注意

#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

注釈

削除するログがローカルコンピューターにある場合は、このメソッドを使用します。適切なレジストリアクセス許可があれば、コンピューター上の任意のログを削除できます。

Delete によって指定された logName ログがローカルコンピューターから削除されます。ログに登録されているソースのみを削除する場合は、を呼び出します DeleteEventSource。ログエントリのみを削除する場合は、を呼び出します Clear。 Delete と DeleteEventSource は static メソッドであるため、クラス自体で呼び出すことができます。どちらのメソッドも呼び出すために、の EventLog 新しいインスタンスを作成する必要はありません。

メソッドは Delete まず、ログの内容を保持するファイルを削除します。その後、レジストリにアクセスし、そのログに登録されているすべてのイベントソースを削除します。後でログを再作成する場合は、イベントソースを再利用する場合は、再度登録する必要があります。イベントソースを登録せず、他のユーザーがログ名を指定せずにイベントソースに書き込む場合、イベントソースはアプリケーションイベントログに作成されます。そのため、以前に削除して再作成したログにエントリを書き込めたアプリケーションでは、代わりにアプリケーションログに書き込まれます。これは、イベントソースが含まれるようになったためです。

注意

こちらもご覧ください

適用対象

次の方法で共有

EventLog.Delete メソッド

定義

オーバーロード

Delete(String, String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Delete(String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース