EventLog.Log EventLog.Log EventLog.Log EventLog.Log Property

定義

読み取るログまたは書き込むログの名前を取得または設定します。Gets or sets the name of the log to read from or write to.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }
member this.Log : string with get, set
Public Property Log As String

プロパティ値

ログの名前。The name of the log. ログ名には、アプリケーション ログ名、システム ログ名、セキュリティ ログ名、またはカスタム ログ名を指定できます。This can be Application, System, Security, or a custom log name. 既定値は、空の文字列 ("") です。The default is an empty string ("").

次の例では、ローカル コンピューターのイベント ログ"NewEventLog"のエントリを読み取ります。The following example reads entries in the event log, "NewEventLog", on the local computer.

#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
Imports System.Diagnostics
Imports Microsoft.VisualBasic

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 'Main
End Class 'MySample

注釈

次の 3 つのログ ファイルは、既定で、サーバーが存在します。アプリケーション、システム、およびセキュリティ。Three log files exist by default on the server: Application, System, and Security. アプリケーションとサービスは、アプリケーションのログ ファイルを使用します。Applications and services use the Application log file. デバイス ドライバーは、システム ログ ファイルを使用します。Device drivers use the System log file. 監査をオンにすると、セキュリティ ログで成功と失敗の監査イベントが生成されます。The system generates success and failure audit events in the Security log when auditing is turned on. Windows のサーバー上の Active Directory のように、インストールされている他のアプリケーションがある場合、その他の既定のログ ファイルがあります。If you have other applications installed, like Active Directory on Windows servers, there might be other default log files. さらに、ローカルまたはリモート コンピューター上のカスタム ログ ファイルを作成することができます。In addition, you can create custom log files on a local or remote computer. カスタム ログは、既定のアプリケーション ログにイベントを書き込むときに許可されているより詳細な方法で、エントリを整理します。Custom logs help organize your entries in a more detailed way than is allowed when your components write events to the default Application log.

注意

ログ名は、8 文字に制限されます。Log names are limited to eight characters. システムに従って MyLogSample1 と MyLogSample2 は、同じログです。According to the system, MyLogSample1 and MyLogSample2 are the same log.

イベント ログに記述する場合は指定するのに十分なLogプロパティ。If you write to an event log, it is not enough to specify the Log property. 関連付ける必要があります、Source特定のログに接続するようにイベント ログ リソースを持つプロパティです。You must associate a Source property with your event log resource to connect it to a particular log. 指定する必要はありません、Sourceときに、ログがイベント ソースからの読み取りのみがあります、サーバーのレジストリのイベント ログのリソースに関連付けられています。It is not necessary to specify a Source when only reading from a log, but an event source must be associated with the event log resource in the server's registry. のみを指定することができます、Log名とMachineNameからの読み取りに (サーバーのコンピューター名)。You can specify only the Log name and MachineName (server computer name) to read from it.

注意

指定する必要はありません、MachineNameをログに接続している場合。You are not required to specify the MachineName if you are connecting to a log. 指定しない場合、 MachineName、ローカル コンピューター (".") と見なされます。If you do not specify the MachineName, the local computer (".") is assumed.

場合、Sourceプロパティが指定されていないへの呼び出しLog場合は、空の文字列を返しますLog明示的に設定されていません (設定して、Logプロパティ、またはコンス トラクターを使用)。If the Source property has not been specified, a call to Log returns an empty string if Log has not been explicitly set (by setting the Log property, or through the constructor). 場合、Sourceが指定されているLogそのソースが登録されているログの名前を返します。If the Source has been specified, Log returns the name of the log to which that source was registered.

ソースは、一度に 1 つのログにのみ登録できます。A source can only be registered to one log at a time. 場合、Sourceのインスタンスのプロパティが設定されたEventLog、変更することはできません、LogプロパティをEventLogの値を変更することがなくSource呼び出しまたはDeleteEventSource最初。If the Source property was set for an instance of EventLog, you cannot change the Log property for that EventLog without changing the value of Source or calling DeleteEventSource first. 変更する場合、Logプロパティの後、Sourceプロパティが設定されて、例外をスローするログ エントリを記述します。If you change the Log property after the Source property has been set, writing a log entry throws an exception.

オペレーティング システムは、イベント ログをファイルとして格納します。The operating system stores event logs as files. 使用するとEventLogInstallerまたはCreateEventSource指定したコンピューター上の %SystemRoot%\System32\Config ディレクトリに新しいイベント ログを作成する、関連付けられたファイルが格納されています。When you use EventLogInstaller or CreateEventSource to create a new event log, the associated file is stored in the %SystemRoot%\System32\Config directory on the specified computer. 最初の 8 文字を付加して、ファイル名が設定されて、 Log ".evt"ファイル名拡張子を持つプロパティです。The file name is set by appending the first 8 characters of the Log property with the ".evt" file name extension.

使用して新しいログを作成することはできません、Logプロパティ (なし、ログのソースを指定する) だけです。You cannot create a new log using the Log property alone (without specifying a source for the log). 呼び出すことができますCreateEventSource、新しいログ名をパラメーターとして渡してを呼び出してDeleteEventSourceします。You can call CreateEventSource, passing in a new log name as a parameter, and then call DeleteEventSource. ただし、目的は、通常、作成 (および、エントリを書き込む) をアプリケーションに固有の新しいログや、既存のログからの読み取り。However, the intent is usually either to create (and write entries to) new application-specific logs, or to read from existing logs.

場合、Log値の変更は、イベント ログが閉じられ、すべてのイベント ハンドルが解放されます。If the Log value changes, the event log is closed and all event handles are released.

注意事項

設定した場合、Logプロパティが存在しないログの名前をシステムのアタッチ、EventLogアプリケーション ログには、警告ログ以外に指定した 1 つのログが使用されているが、します。If you set the Log property to the name of a log that does not exist, the system attaches the EventLog to the Application log, but does not warn you that it is using a log other than the one you specified.

セキュリティ

EventLogPermission
コンピューターのイベント ログ情報を書き込む。for writing the event log information on the computer. 関連付けられた列挙体。 WriteAssociated enumeration: Write

適用対象

こちらもご覧ください