EventLog.Log プロパティ

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.EventLog.dll

パッケージ:

System.Diagnostics.EventLog v8.0.0

ソース:

EventLog.cs

読み取るログまたは書き込むログの名前を取得または設定します。

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Log : string with get, set

Public Property Log As String

プロパティ値

String

ログの名前。 ログ名には、アプリケーション ログ名、システム ログ名、セキュリティ ログ名、またはカスタム ログ名を指定できます。 既定値は、空の文字列 ("") です。

属性

SettingsBindableAttribute

例

次の例では、ローカル コンピューターのイベント ログ "NewEventLog" のエントリを読み取ります。

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myNewLog = gcnew EventLog;
   myNewLog->Log = "NewEventLog";
   System::Collections::IEnumerator^ myEnum = myNewLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

using System;
using System.Diagnostics;

class MySample{

    public static void Main(){

        EventLog myNewLog = new EventLog();
        myNewLog.Log = "NewEventLog";
        foreach(EventLogEntry entry in myNewLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }
    }
}

Imports System.Diagnostics

Class MySample
    Public Shared Sub Main()
        Dim myNewLog As New EventLog()
        myNewLog.Log = "NewEventLog"
        Dim entry As EventLogEntry
        For Each entry In  myNewLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub
End Class

注釈

サーバーには、アプリケーション、システム、セキュリティの 3 つのログ ファイルが既定で存在します。 アプリケーションとサービスでは、アプリケーション ログ ファイルが使用されます。 デバイス ドライバーは、システム ログ ファイルを使用します。 監査が有効になっていると、セキュリティ ログに成功と失敗の監査イベントが生成されます。 Windows サーバー上の Active Directory など、他のアプリケーションがインストールされている場合は、他の既定のログ ファイルが存在する可能性があります。 さらに、ローカル コンピューターまたはリモート コンピューターにカスタム ログ ファイルを作成することもできます。 カスタム ログは、コンポーネントが既定のアプリケーション ログにイベントを書き込む場合よりも詳細な方法でエントリを整理するのに役立ちます。

注意

ログ名は 8 文字に制限されています。 システムによると、MyLogSample1 と MyLogSample2 は同じログです。

イベント ログに書き込む場合は、 プロパティを指定 Log するだけでは十分ではありません。 特定のログに接続するには、 Source プロパティをイベント ログ リソースに関連付ける必要があります。 ログからの読み取りのみを行う場合は を Source 指定する必要はありませんが、イベント ソースをサーバーのレジストリのイベント ログ リソースに関連付ける必要があります。 読み取る Log 名前と MachineName (サーバー コンピューター名) のみを指定できます。

注意

ログに接続する場合は、 を MachineName 指定する必要はありません。 を指定しない場合は MachineName、ローカル コンピューター (".") が想定されます。

プロパティが Source 指定されていない場合、 の Log 呼び出しは、明示的に設定されていない場合 Log は空の文字列を返します (プロパティを Log 設定するか、コンストラクターを介して)。 が Source 指定されている場合は、 Log そのソースが登録されたログの名前を返します。

ソースは、一度に 1 つのログにのみ登録できます。 のインスタンスEventLogに Source 対して プロパティが設定されている場合は、 の値を変更したり、最初に Log を呼び出DeleteEventSourceしたりしないと、 のSourceプロパティEventLogを変更することはできません。 プロパティが Log 設定された後で プロパティを Source 変更すると、ログ エントリを記述すると例外がスローされます。

オペレーティング システムではイベント ログはファイルとして保存されます。 または CreateEventSource を使用EventLogInstallerして新しいイベント ログを作成すると、関連付けられているファイルは、指定したコンピューターの %SystemRoot%\System32\Config ディレクトリに格納されます。 ファイル名は、プロパティの最初の 8 文字 Log に ".evt" ファイル名拡張子を付加することによって設定されます。

プロパティを単独で使用して新しいログを Log 作成することはできません (ログのソースを指定しない)。 を呼び出 CreateEventSourceして、新しいログ名をパラメーターとして渡し、 を呼び出 DeleteEventSourceすことができます。 ただし、意図は通常、新しいアプリケーション固有のログを作成 (および書き込み) するか、既存のログから読み取るかのどちらかです。

値が変更されると Log 、イベント ログは閉じられ、すべてのイベント ハンドルが解放されます。

注意事項

存在しないログの名前に プロパティを設定 Log した場合、システムは をアプリケーション ログにアタッチ EventLog しますが、指定したログ以外のログを使用していることを警告しません。

こちらもご覧ください

• MachineName
• Source
• Entries
• Exists(String)
• Delete(String)
• CreateEventSource
• EventLogEntryCollection