EventLog.Exists メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.EventLog.dll

パッケージ:

System.Diagnostics.EventLog v8.0.0

指定したログが存在するかどうかを確認します。

オーバーロード

Exists(String)	ローカル コンピューター上にログが存在するかどうかを確認します。
Exists(String, String)	指定したコンピューター上にログが存在するかどうかを確認します。

Exists(String)

ソース:

EventLog.cs

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

public:
 static bool Exists(System::String ^ logName);

public static bool Exists (string logName);

static member Exists : string -> bool

Public Shared Function Exists (logName As String) As Boolean

パラメーター

logName

String

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

戻り値

Boolean

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

例外

ArgumentException

logName が null です。または値が空です。

例

      String^ myLog = "myNewLog";
      if ( EventLog::Exists( myLog ) )
      {
         Console::WriteLine( "Log '{0}' exists.", myLog );
      }
      else
      {
         Console::WriteLine( "Log '{0}' does not exist.", myLog );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }

}

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

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

注釈

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

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

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

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

こちらもご覧ください

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log

Exists(String, String)

ソース:

EventLog.cs

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

public:
 static bool Exists(System::String ^ logName, System::String ^ machineName);

public static bool Exists (string logName, string machineName);

static member Exists : string * string -> bool

Public Shared Function Exists (logName As String, machineName As String) As Boolean

パラメーター

logName

String

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

machineName

String

ログ検索の対象となるコンピューターの名前。ローカル コンピューターの場合は "."。

戻り値

Boolean

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

例外

ArgumentException

machineName パラメーターの書式が無効です。 検索しているコンピューターに対して正しい構文を使用したかどうかを確認してください。

- または -

logName が null です。または値が空です。

注釈

リモート コンピューターにログが存在するかどうかを確認するには、このメソッドを使用します。 ソースがリモート コンピューターに存在するかどうかを確認する場合は、 を使用 SourceExistsします。

このメソッドはレジストリにアクセスするため、指定したコンピューターに対する適切なレジストリアクセス許可が必要です。それ以外の場合、クエリは を返します false。

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

Existsstaticは メソッドであるため、クラス自体で呼び出すことができます。 を呼び出Existsすために のEventLog新しいインスタンスを作成する必要はありません。

こちらもご覧ください

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log
• MachineName