EventLog.Exists メソッド (String)

ローカル コンピュータ上にログが存在するかどうかを確認します。

Overloads Public Shared Function Exists( _
   ByVal logName As String _) As Boolean
[C#]
public static bool Exists(stringlogName);
[C++]
public: static bool Exists(String* logName);
[JScript]
public static function Exists(
   logName : String) : Boolean;

パラメータ

• logName
  検索するログの名前。指定できる値は、アプリケーション、セキュリティ、システム、アプリケーション固有のその他のログ (Active Directory に関連するログなど)、またはコンピュータ上の任意のカスタム ログです。

戻り値

ローカル コンピュータ上にログが存在する場合は true 。それ以外の場合は false 。

例外

解説

このメソッドは、ローカル コンピュータ上にログが存在するかどうかを確認するときに使用します。ローカル コンピュータ上にソースが存在するかどうかを確認する場合は、 SourceExists を使用してください。

このメソッドはレジストリにアクセスするため、ローカル コンピュータ上で適切なレジストリ アクセス許可を持っている必要があります。このアクセス許可がない場合、クエリは false を返します。

新しいログには同じコンピュータ上の既存のログ名を付けることはできません。したがって、新しいログを作成する前にこのメソッドを使用して、指定した logName が既にローカル コンピュータに存在しているかどうかを確認します。 logName パラメータでは大文字と小文字が区別されません。

Exists は静的 (Visual Basic では Shared) メソッドであるため、そのクラス自体で呼び出すことができます。 Exists を呼び出すために EventLog のインスタンスを作成する必要はありません。

使用例

 
Dim myLog As String = "myNewLog"
If EventLog.Exists(myLog) Then
   Console.WriteLine("Log '" + myLog + "' exists.")
Else
   Console.WriteLine("Log '" + myLog + "' does not exist.")
End If

[C#] 
string myLog = "myNewLog";
if (EventLog.Exists(myLog))
{
   Console.WriteLine("Log '"+myLog+"' exists.");
}
else
{
   Console.WriteLine("Log '"+myLog+"' does not exist.");
}

[C++] 
String* myLog = S"myNewLog";
if (EventLog::Exists(myLog)) {
    Console::WriteLine(S"Log '{0}' exists.", myLog);
} else {
    Console::WriteLine(S"Log '{0}' does not exist.", myLog);
}

[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 (コンピュータ上のイベント ログ情報にアクセスするのに必要なアクセス許可)
• RegistryPermission (コンピュータ上のイベント ログ レジストリ情報にアクセスするのに必要なアクセス許可)
• SecurityPermission (完全信頼を指定して EventLog のメンバを呼び出すためのアクセス許可) PermissionState.Unrestricted (関連する列挙体)

参照

EventLog クラス | EventLog メンバ | System.Diagnostics 名前空間 | EventLog.Exists オーバーロードの一覧 | CreateEventSource | Delete | SourceExists | Log