EventLog.WriteEntry メソッド

定義

名前空間:: System.Diagnostics

アセンブリ:: System.Diagnostics.EventLog.dll

アセンブリ:: System.dll

パッケージ:: System.Diagnostics.EventLog v11.0.0-preview.2.26159.112

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

イベントログにエントリを書き込みます。

オーバーロード

名前	説明
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])	指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込み (指定した登録済みイベントソースを使用)、バイナリデータをメッセージに追加します。
WriteEntry(String, String, EventLogEntryType, Int32, Int16)	指定した登録済みイベントソースを使用して、指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込みます。 `category`は、イベントビューアーでログ内のイベントをフィルター処理するために使用できます。
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])	指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込み、バイナリデータをメッセージに追加します。
WriteEntry(String, String, EventLogEntryType, Int32)	指定した登録イベントソースを使用して、指定されたメッセージテキストとアプリケーション定義のイベント識別子を持つエントリをイベントログに書き込みます。
WriteEntry(String, EventLogEntryType, Int32, Int16)	指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込みます。
WriteEntry(String, EventLogEntryType)	指定されたメッセージテキストを含むエラー、警告、情報、成功監査、または失敗監査エントリをイベントログに書き込みます。
WriteEntry(String, EventLogEntryType, Int32)	指定されたメッセージテキストとアプリケーション定義のイベント識別子を持つエントリをイベントログに書き込みます。
WriteEntry(String, String)	指定した登録済みイベントソースを使用して、指定されたメッセージテキストを含む情報の種類のエントリをイベントログに書き込みます。
WriteEntry(String)	指定されたメッセージテキストを含む情報の種類のエントリをイベントログに書き込みます。
WriteEntry(String, String, EventLogEntryType)	指定した登録済みイベントソースを使用して、指定されたメッセージテキストを含むエラー、警告、情報、成功監査、または失敗監査エントリをイベントログに書き込みます。

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込み (指定した登録済みイベントソースを使用)、バイナリデータをメッセージに追加します。

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

パラメーター

source: String

指定したコンピューターにアプリケーションを登録するソース。

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

eventID: Int32

イベントのアプリケーション固有の識別子。

category: Int16

メッセージに関連付けられているアプリケーション固有のサブカテゴリ。

rawData: Byte[]

エントリに関連付けられているバイナリデータを保持するバイトの配列。

例外

ArgumentException

source値は空の文字列 ("") です。

-又は-

source値はnull。

-又は-

eventID が 0 より小さいか、UInt16.MaxValue より大きい値です。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

Win32Exception

イベントエントリをイベントログに書き込むときに、オペレーティングシステムからエラーが報告されました。 Windows エラーコードは使用できません。

例

//Create a byte array for binary data to associate with the entry.
byte[] myByte = new byte[10];
//Populate the byte array with simulated data.
for (int i = 0; i < 10; i++)
{
    myByte[i] = (byte)(i % 2);
}
// Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ");
EventLog.WriteEntry("SecondSource", "Writing warning to event log.",
                     EventLogEntryType.Error, myEventID, myCategory, myByte);

' Create a byte array for binary data to associate with the entry.
Dim myByte(9) As Byte
Dim i As Integer
' Populate the byte array with simulated data.
For i = 0 To 9
    myByte(i) = CByte(i Mod 2)
Next i
' Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ")
EventLog.WriteEntry("SecondSource", "Writing warning to event log.", _
                     EventLogEntryType.Error, myEventID, myCategory, myByte)

注釈

適切なログのイベントソースとして既に登録されているソースを使用して、アプリケーション定義のイベント固有のデータをイベントログに書き込むには、このメソッドを使用します。イベントビューアーでは、このデータは解釈されません。生データは、16 進数とテキストの組み合わせ形式でのみ表示されます。イベント固有のデータを控えめに使用する。それが役に立つと確信している場合にのみ、それを含めます。また、イベント固有のデータを使用して、アプリケーションがイベントビューアーとは別に処理できる情報を格納することもできます。たとえば、イベント専用のビューアーを作成したり、ログファイルをスキャンしてイベント固有のデータからの情報を含むレポートを作成するプログラムを作成したりできます。

バイナリデータに加えて、アプリケーション定義のカテゴリとアプリケーション定義のイベント識別子を指定できます。イベントビューアーは、カテゴリを使用して、イベントソースによって書き込まれたイベントをフィルター処理します。イベントビューアーでは、カテゴリを数値として表示することも、カテゴリをリソース識別子として使用してローカライズされたカテゴリ文字列を表示することもできます。

注

category パラメーターは正の値にする必要があります。負のカテゴリ値は、イベントビューアーで補完正の数として表示されます。たとえば、-10 は 65,526、-1 は 65,535 と表示されます。

ローカライズされたカテゴリ文字列をイベントビューアーに表示するには、カテゴリリソースファイルで構成されたイベントソースを使用し、カテゴリリソースファイルのリソース識別子に category を設定する必要があります。イベントソースにカテゴリリソースファイルが構成されていない場合、または指定した category がカテゴリリソースファイル内の文字列のインデックスを作成しない場合、イベントビューアーには、そのエントリの数値カテゴリ値が表示されます。 EventLogInstallerまたはEventSourceCreationData クラスを使用して、カテゴリリソースファイルとリソースファイル内のカテゴリ文字列の数を構成します。

イベント識別子とイベントソースは、イベントを一意に識別します。各アプリケーションは、独自の番号付きイベントと、マップ先の説明文字列を定義できます。イベントビューアーは、ユーザーが問題を理解し、実行するアクションを提案するために、これらの文字列値を表示します。

最後に、イベントログに書き込まれるイベントの EventLogEntryType を指定できます。 typeは、ログのイベントビューアーの [種類] 列のアイコンとテキストによって示されます。このパラメーターは、イベントの種類がエラー、警告、情報、成功監査、または失敗監査のどちらであるかを示します。

最初のエントリをソースに書き込む前に、イベントソースを作成して構成する必要があります。アプリケーションのインストール中に新しいイベントソースを作成します。これにより、オペレーティングシステムが登録されているイベントソースとその構成の一覧を更新する時間が得られます。オペレーティングシステムがイベントソースの一覧を更新せず、新しいソースでイベントを書き込もうとすると、書き込み操作は失敗します。新しいソースは、 EventLogInstallerを使用するか、 CreateEventSource メソッドを使用して構成できます。新しいイベントソースを作成するには、コンピューターの管理者権限が必要です。

ソースは、ローカライズされたエントリの書き込みまたは直接文字列の書き込み用に構成する必要があります。 WriteEntry メソッドは、指定された文字列をイベントログに直接書き込みます。ローカライズ可能なメッセージリソースファイルは使用しません。ローカライズされたメッセージリソースファイルを使用してイベントを書き込むには、 WriteEvent メソッドを使用します。

アプリケーションがリソース識別子と文字列値の両方を使用してエントリを書き込む場合は、2 つの個別のソースを登録する必要があります。たとえば、リソースファイルを使用して 1 つのソースを構成し、 WriteEvent メソッドでそのソースを使用して、リソース識別子を使用してエントリをイベントログに書き込みます。次に、リソースファイルのない別のソースを作成し、 WriteEntry メソッドでそのソースを使用して、そのソースを使用してイベントログに直接文字列を書き込みます。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

イベントビューアーでは挿入文字列として扱われるため、 message 文字列には %n を含めることはできません 。n は 整数値 (たとえば、%1) です。インターネットプロトコル、バージョン 6 (IPv6) アドレスにはこの文字シーケンスを含めることができるため、IPv6 アドレスを含むイベントメッセージをログに記録することはできません。

こちらもご覧ください

適用対象

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定した登録済みイベントソースを使用して、指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込みます。 categoryは、イベントビューアーでログ内のイベントをフィルター処理するために使用できます。

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short)

パラメーター

source: String

指定したコンピューターにアプリケーションを登録するソース。

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

eventID: Int32

イベントのアプリケーション固有の識別子。

category: Int16

メッセージに関連付けられているアプリケーション固有のサブカテゴリ。

例外

ArgumentException

source値は空の文字列 ("") です。

-又は-

source値はnull。

-又は-

eventID が 0 より小さいか、UInt16.MaxValue より大きい値です。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

Win32Exception

例

int myEventID = 20;
short myCategory = 10;
// Write an informational entry to the event log.
Console.WriteLine("Write from first source ");
EventLog.WriteEntry("FirstSource", "Writing warning to event log.",
                     EventLogEntryType.Information, myEventID, myCategory);

Dim myEventID As Integer = 10
Dim myCategory As Short = 20
' Write an informational entry to the event log.
Console.WriteLine("Write from first source ")
EventLog.WriteEntry("FirstSource", "Writing warning to event log.", _
                           EventLogEntryType.Information, myEventID, myCategory)

注釈

適切なログのイベントソースとして既に登録されているソースを使用して、アプリケーション定義の category を持つエントリをイベントログに書き込むには、このメソッドを使用します。イベントビューアーは、カテゴリを使用して、イベントソースによって書き込まれたイベントをフィルター処理します。イベントビューアーでは、カテゴリを数値として表示することも、カテゴリをリソース識別子として使用してローカライズされたカテゴリ文字列を表示することもできます。

注

カテゴリに加えて、イベントログに書き込まれるイベントのイベント識別子を指定できます。イベント識別子とイベントソースは、イベントを一意に識別します。各アプリケーションは、独自の番号付きイベントと、マップ先の説明文字列を定義できます。イベントビューアーは、ユーザーが問題を理解し、実行するアクションを提案するために、これらの文字列値を表示します。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込み、バイナリデータをメッセージに追加します。

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

パラメーター

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

eventID: Int32

イベントのアプリケーション固有の識別子。

category: Int16

メッセージに関連付けられているアプリケーション固有のサブカテゴリ。

rawData: Byte[]

エントリに関連付けられているバイナリデータを保持するバイトの配列。

例外

ArgumentException

EventLogのSource プロパティが設定されていません。

-又は-

メソッドは新しいイベントソースを登録しようとしましたが、 MachineName のコンピューター名が無効です。

-又は-

ソースは既に別のイベントログに登録されています。

-又は-

eventID が 0 より小さいか、UInt16.MaxValue より大きい値です。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

Win32Exception

例

// Create the source, if it does not already exist.
string myLogName = "myNewLog";
if(!EventLog.SourceExists("MySource"))
{
   // An event log source should not be created and immediately used.
   // There is a latency time to enable the source, it should be created
   // prior to executing the application that uses the source.
   // Execute this sample a second time to use the new source.
   EventLog.CreateEventSource("MySource", myLogName);
   Console.WriteLine("Created EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   return;
}
else
   {
       myLogName = EventLog.LogNameFromSourceName("MySource",".");
   }
   // Create an EventLog and assign source.
   EventLog myEventLog = new EventLog();
myEventLog.Source = "MySource";
myEventLog.Log = myLogName;

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicatinEventId = 1100;
short myApplicatinCategoryId = 1;

// Set the 'data' for the event.
byte[] myRawData = new byte[4];
for(int i=0;i<4;i++)
{
   myRawData[i]=1;
}
// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
myEventLog.WriteEntry(myMessage,myEventLogEntryType,
   myApplicatinEventId, myApplicatinCategoryId, myRawData);

' Create the source, if it does not already exist.
dim myLogName as string = "myNewLog"
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", myLogName)
   Console.WriteLine("Creating EventSource")
else
   myLogName = EventLog.LogNameFromSourceName("MySource",".")
End If

' Create an EventLog and assign source.
Dim myEventLog As New EventLog()
myEventLog.Source = "MySource"
myEventLog.Log = myLogName

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicatinEventId As Integer = 1100
Dim myApplicatinCategoryId As Short = 1

' Set the 'data' for the event.
Dim myRawData(3) As Byte
Dim i As Integer
For i = 0 To 3
   myRawData(i) = 1
Next i
' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
myEventLog.WriteEntry(myMessage, myEventLogEntryType, myApplicatinEventId, _
                     myApplicatinCategoryId, myRawData)

注釈

このオーバーロードを使用して、アプリケーション定義のイベント固有のデータをイベントログに書き込みます。イベントビューアーでは、このデータは解釈されません。生データは、16 進数とテキストの組み合わせ形式でのみ表示されます。イベント固有のデータは、問題をデバッグしているユーザーにとって役に立つと確信している場合にのみ含め、控えめに使用してください。また、イベント固有のデータを使用して、アプリケーションがイベントビューアーとは別に処理できる情報を格納することもできます。たとえば、イベント専用のビューアーを作成したり、ログファイルをスキャンしてイベント固有のデータからの情報を含むレポートを作成するプログラムを作成したりできます。

注

ログにエントリを書き込む前に、EventLog コンポーネントに Source プロパティを設定する必要があります。最初のエントリをソースに書き込む前に、イベントソースを作成して構成する必要があります。

アプリケーションのインストール中に新しいイベントソースを作成します。これにより、オペレーティングシステムが登録されているイベントソースとその構成の一覧を更新する時間が得られます。オペレーティングシステムがイベントソースの一覧を更新せず、新しいソースでイベントを書き込もうとすると、書き込み操作は失敗します。新しいソースは、 EventLogInstallerを使用するか、 CreateEventSource メソッドを使用して構成できます。新しいイベントソースを作成するには、コンピューターの管理者権限が必要です。

このEventLog インスタンスのSource プロパティで指定されたソースが、コンポーネントの書き込み先のコンピューターに登録されていない場合は、WriteEntry CreateEventSourceを呼び出し、ソースを登録します。

注

CreateEventSourceまたはWriteEntryを呼び出す前に、EventLog インスタンスのMachineNameを指定しない場合は、ローカルコンピューター (".") が想定されます。

システムがWriteEntryの呼び出しを通じてSourceを登録する必要があり、EventLog インスタンスで Log プロパティが設定されていない場合、ログは既定でアプリケーションログに設定されます。

注

上記の例外の多くは、 Sourceの登録プロセス中に発生したエラーによって生成されます。

注

リモートコンピューターにエントリを書き込む場合、リモートコンピューターが .NET Framework を実行していない場合、メッセージの値 (テキスト文字列) が予期した値にならない可能性があります。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String, String, EventLogEntryType, Int32)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定した登録イベントソースを使用して、指定されたメッセージテキストとアプリケーション定義のイベント識別子を持つエントリをイベントログに書き込みます。

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer)

パラメーター

source: String

指定したコンピューターにアプリケーションを登録するソース。

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

eventID: Int32

イベントのアプリケーション固有の識別子。

例外

ArgumentException

source値は空の文字列 ("") です。

-又は-

source値はnull。

-又は-

eventID が 0 より小さいか、UInt16.MaxValue より大きい値です。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

Win32Exception

例

// Create the source, if it does not already exist.
if(!EventLog.SourceExists("MySource"))
{
   // An event log source should not be created and immediately used.
   // There is a latency time to enable the source, it should be created
   // prior to executing the application that uses the source.
   // Execute this sample a second time to use the new source.
   EventLog.CreateEventSource("MySource", "myNewLog");
   Console.WriteLine("Creating EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   // The source is created.  Exit the application to allow it to be registered.
   return;
}

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicationEventId = 100;

// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
EventLog.WriteEntry("MySource",myMessage,
   myEventLogEntryType, myApplicationEventId);

' Create the source, if it does not already exist.
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", "myNewLog")
   Console.WriteLine("Creating EventSource")
End If

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicationEventId As Integer = 100

' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
EventLog.WriteEntry("MySource", myMessage, myEventLogEntryType, myApplicationEventId)

注釈

適切なログのイベントソースとして既に登録されているソースを使用して、アプリケーション定義の eventID を持つエントリをイベントログに書き込むには、このメソッドを使用します。 eventIDは、ソースと共に、イベントを一意に識別します。各アプリケーションは、独自の番号付きイベントと、マップ先の説明文字列を定義できます。イベントビューアーは、ユーザーにこれらの文字列を提示して、ユーザーが問題を理解し、実行するアクションを提案するのに役立ちます。

注

この WriteEntry のオーバーロードでは、イベント識別子に加えて、イベントログに書き込まれるイベントの EventLogEntryType を指定できます。 typeは、ログのイベントビューアーの [種類] 列のアイコンとテキストによって示されます。このパラメーターは、イベントの種類がエラー、警告、情報、成功監査、または失敗監査のどちらであるかを示します。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType, Int32, Int16)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定されたメッセージテキスト、アプリケーション定義イベント識別子、およびアプリケーション定義カテゴリを含むエントリをイベントログに書き込みます。

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short)

パラメーター

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

eventID: Int32

イベントのアプリケーション固有の識別子。

category: Int16

メッセージに関連付けられているアプリケーション固有のサブカテゴリ。

例外

ArgumentException

EventLogのSource プロパティが設定されていません。

-又は-

メソッドは新しいイベントソースを登録しようとしましたが、 MachineName のコンピューター名が無効です。

-又は-

ソースは既に別のイベントログに登録されています。

-又は-

eventID が 0 より小さいか、UInt16.MaxValue より大きい値です。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

Win32Exception

例

// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "ThirdSource";

// Write an informational entry to the event log.
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);

' Create an EventLog instance and assign its source.
Dim myLog As New EventLog()
myLog.Source = "ThirdSource"

' Write an informational entry to the event log.
Console.WriteLine("Write from third source ")
myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning, _
                     myEventID, myCategory)

注釈

このメソッドを使用して、アプリケーション定義の category を含むエントリをイベントログに書き込みます。イベントビューアーは、カテゴリを使用して、イベントソースによって書き込まれたイベントをフィルター処理します。イベントビューアーでは、カテゴリを数値として表示することも、カテゴリをリソース識別子として使用してローカライズされたカテゴリ文字列を表示することもできます。

注

CreateEventSourceまたはWriteEntryを呼び出す前に、EventLog インスタンスのMachineNameを指定しない場合は、ローカルコンピューター (".") が想定されます。

注

上記の例外の多くは、 Sourceの登録プロセス中に発生したエラーによって生成されます。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定されたメッセージテキストを含むエラー、警告、情報、成功監査、または失敗監査エントリをイベントログに書き込みます。

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType)

パラメーター

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

例外

ArgumentException

EventLogのSource プロパティが設定されていません。

-又は-

メソッドは新しいイベントソースを登録しようとしましたが、 MachineName のコンピューター名が無効です。

-又は-

ソースは既に別のイベントログに登録されています。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

Win32Exception

例

次の例では、ローカルコンピューター上のイベントログ "MyNewLog" に警告エントリを書き込みます。

using System;
using System.Diagnostics;
using System.Threading;

class MySample1
{

    public static void Main()
    {

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog("MyNewLog");
        myLog.Source = "MyNewLogSource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning);
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog("MyNewLog")
        myLog.Source = "MyNewLogSource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning)
    End Sub
End Class

注釈

指定した EventLogEntryType のエントリをイベントログに書き込むには、このメソッドを使用します。 typeは、ログのイベントビューアーの [種類] 列のアイコンとテキストによって示されます。

注

CreateEventSourceまたはWriteEntryを呼び出す前に、EventLog インスタンスのMachineNameを指定しない場合は、ローカルコンピューター (".") が想定されます。

注

上記の例外の多くは、 Sourceの登録プロセス中に発生したエラーによって生成されます。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType, Int32)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定されたメッセージテキストとアプリケーション定義のイベント識別子を持つエントリをイベントログに書き込みます。

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer)

パラメーター

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

eventID: Int32

イベントのアプリケーション固有の識別子。

例外

ArgumentException

EventLogのSource プロパティが設定されていません。

-又は-

メソッドは新しいイベントソースを登録しようとしましたが、 MachineName のコンピューター名が無効です。

-又は-

ソースは既に別のイベントログに登録されています。

-又は-

eventID が 0 より小さいか、UInt16.MaxValue より大きい値です。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

Win32Exception

例

// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "ThirdSource";

// Write an informational entry to the event log.
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);

' Create an EventLog instance and assign its source.
Dim myLog As New EventLog()
myLog.Source = "ThirdSource"

' Write an informational entry to the event log.
Console.WriteLine("Write from third source ")
myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning, _
                     myEventID, myCategory)

注釈

このメソッドを使用して、アプリケーション定義の eventID を含むエントリをイベントログに書き込みます。 eventIDソースと共にイベントを一意に識別します。各アプリケーションは、独自の番号付きイベントと、マップ先の説明文字列を定義できます。イベントビューアーは、ユーザーが問題を理解し、実行するアクションを提案するために、これらの文字列値を表示します。

注

イベント識別子に加えて、イベントログに書き込まれるイベントの EventLogEntryType を指定できます。 typeは、ログのイベントビューアーの [種類] 列のアイコンとテキストによって示されます。このパラメーターは、イベントの種類がエラー、警告、情報、成功監査、または失敗監査のどちらであるかを示します。

注

CreateEventSourceまたはWriteEntryを呼び出す前に、EventLog インスタンスのMachineNameを指定しない場合は、ローカルコンピューター (".") が想定されます。

注

上記の例外の多くは、 Sourceの登録プロセス中に発生したエラーによって生成されます。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String, String)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定した登録済みイベントソースを使用して、指定されたメッセージテキストを含む情報の種類のエントリをイベントログに書き込みます。

public:
 static void WriteEntry(System::String ^ source, System::String ^ message);

public static void WriteEntry(string source, string message);

static member WriteEntry : string * string -> unit

Public Shared Sub WriteEntry (source As String, message As String)

パラメーター

source: String

指定したコンピューターにアプリケーションを登録するソース。

message: String

イベントログに書き込む文字列。

例外

ArgumentException

source値は空の文字列 ("") です。

-又は-

source値はnull。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

Win32Exception

例

次の例では、ソース MySource がまだ存在しない場合は作成し、イベントログ MyNewLogにエントリを書き込みます。

using System;
using System.Diagnostics;
using System.Threading;

class MySample
{

    public static void Main()
    {

        // Create the source, if it does not already exist.
        if (!EventLog.SourceExists("MySource"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "myNewLog");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource", "Writing to event log.");
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "myNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing to event log.")
    End Sub
End Class

注釈

このメソッドを使用して、適切なログのイベントソースとして既に登録されているソースを使用して、イベントログに情報エントリを書き込みます。他の EventLogEntryTypeを指定する場合は、 WriteEntryの別のオーバーロードを使用します。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定されたメッセージテキストを含む情報の種類のエントリをイベントログに書き込みます。

public:
 void WriteEntry(System::String ^ message);

public void WriteEntry(string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

パラメーター

message: String

イベントログに書き込む文字列。

例外

ArgumentException

EventLogのSource プロパティが設定されていません。

-又は-

メソッドは新しいイベントソースを登録しようとしましたが、 MachineName のコンピューター名が無効です。

-又は-

ソースは既に別のイベントログに登録されています。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

Win32Exception

例

次の例では、ソース MySource がまだ存在しない場合は作成し、イベントログ MyNewLogにエントリを書き込みます。

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

注釈

このメソッドを使用して、この EventLog インスタンスに関連付けられているイベントログに情報エントリを書き込みます。他の EventLogEntryTypeを指定する場合は、 WriteEntryの別のオーバーロードを使用します。

注

CreateEventSourceまたはWriteEntryを呼び出す前に、EventLog インスタンスのMachineNameを指定しない場合は、ローカルコンピューター (".") が想定されます。

注

上記の例外の多くは、 Sourceの登録プロセス中に発生したエラーによって生成されます。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

WriteEntry(String, String, EventLogEntryType)

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

ソース:: EventLog.cs

指定した登録済みイベントソースを使用して、指定されたメッセージテキストを含むエラー、警告、情報、成功監査、または失敗監査エントリをイベントログに書き込みます。

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType)

パラメーター

source: String

指定したコンピューターにアプリケーションを登録するソース。

message: String

イベントログに書き込む文字列。

type: EventLogEntryType

EventLogEntryType値の 1 つ。

例外

ArgumentException

source値は空の文字列 ("") です。

-又は-

source値はnull。

-又は-

メッセージ文字列が 31,839 バイト (Windows Vista より前の Windows オペレーティングシステムでは 32,766 バイト) を超えています。

-又は-

ソース名は、254 文字を超えるレジストリキーパスになります。

InvalidOperationException

イベントログのレジストリキーを開くことができませんでした。

InvalidEnumArgumentException

type は有効な EventLogEntryTypeではありません。

Win32Exception

例

次の例では、ローカルコンピューター上のイベントログ "MyNewLog" に警告エントリを書き込みます。

using System;
using System.Diagnostics;
using System.Threading;

class MySample2
{

    public static void Main()
    {

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource",
            "Writing warning to event log.",
            EventLogEntryType.Warning);
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing warning to event log.", _
            EventLogEntryType.Warning)
    End Sub
End Class

注釈

このメソッドを使用して、指定した EventLogEntryType のエントリをイベントログに書き込み、適切なログのイベントソースとして既に登録されているソースを使用します。 typeは、ログのイベントビューアーの [種類] 列のアイコンとテキストによって示されます。

注

message パラメーターに NUL 文字が含まれている場合、イベントログ内のメッセージは NUL 文字で終了します。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?

次の方法で共有

EventLog.WriteEntry メソッド

定義

オーバーロード

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, String, EventLogEntryType, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType, Int32, Int16)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, EventLogEntryType, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteEntry(String, String, EventLogEntryType)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック