EventLog.Clear メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

EventLog.Clear メソッド

イベントログからすべてのエントリを削除します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Clear

Visual Basic (使用法)

Dim instance As EventLog

instance.Clear

public void Clear ()

C++

public:
void Clear ()

public void Clear ()

JScript

public function Clear ()

例外

例外の種類	条件
Win32Exception	イベントログが正常に消去されませんでした。またはログを開くことができません。Windows のエラーコードは使用できません。
ArgumentException	Log プロパティの値が指定されていません。ログ名が空の文字列でないことを確認してください。
InvalidOperationException	ログが存在しません。

例外の種類

条件

Win32Exception

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

または

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

ArgumentException

Log プロパティの値が指定されていません。ログ名が空の文字列でないことを確認してください。

InvalidOperationException

ログが存在しません。

解説

イベントログには最大サイズが設定されており、格納できるエントリの数が制限されます。イベントログが設定されているサイズを超えると、新しいイベント情報の記録が停止されるか、古いエントリが上書きされます。記録が停止した場合は、このメソッドを使用すると、既存のエントリのログを消去し、イベントの記録を再び開始できます。イベントログのエントリを消去するには、ログが存在するコンピュータに対する管理者アクセス許可が必要です。

Clear は、イベントログを閉じてイベントハンドルを解放し、新しい読み取り/書き込みハンドルを取得し、再びイベントログを開きます。このメソッドの呼び出し後に受信されたイベントは、既存のイベントと一緒には消去されません。

使用例

イベントログを消去する例を次に示します。

注意
アプリケーションログ、システムログ、セキュリティログ、およびその他の非カスタムログには重要な情報を格納されている可能性があるため、このサンプルコードを実行する前に、カスタムログに "mySource" が登録されていることを確認してください。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create an EventLog instance and assign its log name.
        Dim myLog As New
 EventLog()
        myLog.Log = "myNewLog"
        
        myLog.Clear()
    End Sub 'Main
End Class 'MySample

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    public static void Main(){
                 
        
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog();
        myLog.Log = "myNewLog";

        myLog.Clear();                                                          
          
    }       
}

C++

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its log name.
   EventLog^ myLog = gcnew EventLog;
   myLog->Log = "myNewLog";
   myLog->Clear();
}

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[]
 args)
    {
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog();
        myLog.set_Log("myNewLog");
        myLog.Clear();
    } //main
} //MySample