EventLog.Clear メソッド

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

Public Sub Clear()
[C#]
public void Clear();
[C++]
public: void Clear();
[JScript]
public function Clear();

例外

解説

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

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

使用例

[Visual Basic, C#, C++] イベント ログを消去する例を次に示します。

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

 
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

[C#] 
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 <mscorlib.dll>
#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 = new EventLog();
    myLog->Log = S"myNewLog";

    myLog->Clear();
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

• EventLogPermission (コンピュータ上のイベント ログ情報を参照するのに必要なアクセス許可)
• SecurityPermission (完全信頼を指定して EventLog のメンバを呼び出すためのアクセス許可) PermissionState.Unrestricted (関連する列挙体)

参照

EventLog クラス | EventLog メンバ | System.Diagnostics 名前空間 | Close | Delete