EventSource.WriteEvent メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたイベント識別子と省略可能な引数を使用して、イベントを書き込みます。
オーバーロード
WriteEvent(Int32, String, String, String) |
指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, String, Int32, Int32) |
指定されたイベント識別子と引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int64, Int64, Int64) |
指定されたイベント識別子と 64 ビットの引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int32, Int32, Int32) |
指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, String, String) |
指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, String, Int64) |
指定されたイベント識別子と引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, String, Int32) |
指定されたイベント識別子と引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int64, String) |
指定されたイベント識別子と 64 ビット整数および文字列引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int64, Int64) |
指定されたイベント識別子と 64 ビットの引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int32, Int32) |
指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int32, String) |
指定されたイベント識別子と 32 ビット整数および文字列引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, String) |
指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Object[]) |
指定されたイベント識別子と引数の配列を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int64) |
指定されたイベント識別子と 64 ビット整数引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int32) |
指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, EventSource+EventSourcePrimitive[]) |
指定されたイベント識別子と、イベント ソース プリミティブの可変数を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Byte[]) |
指定されたイベント識別子とバイト配列引数を使用してイベントを書き込みます。 |
WriteEvent(Int32) |
指定されたイベント識別子を使用して、イベントを書き込みます。 |
WriteEvent(Int32, Int64, Byte[]) |
指定した識別子と 64 ビット整数およびバイト配列引数を使用して、イベント データを書き込みます。 |
注釈
メソッドは WriteEvent
、文字列引数と整数引数の組み合わせを含むオーバーロードを提供します。 これらの組み合わせが呼び出しのパラメーターと一致しない場合、コンパイラは オーバーロードを EventSource.WriteEvent(Int32, Object[]) 使用します。これは、他のオーバーロードよりもかなり遅くなります。 詳細については、オーバーロード のページを参照してください。
いずれの場合も、パラメーターは eventid
0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
メソッドを使用してカスタム オーバーロードを WriteEventCore 作成することもできます。
重要
の型 string
を持つイベント パラメーターには、文字を含 \0
めないようにしてください。 これらはサポートされていない文字であり、イベント ペイロードのパーサーに問題が発生する可能性があります。
WriteEvent(Int32, String, String, String)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, System::String ^ arg1, System::String ^ arg2, System::String ^ arg3);
protected void WriteEvent (int eventId, string arg1, string arg2, string arg3);
protected void WriteEvent (int eventId, string? arg1, string? arg2, string? arg3);
member this.WriteEvent : int * string * string * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String, arg3 As String)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- String
文字列引数。
- arg2
- String
文字列引数。
- arg3
- String
文字列引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, String, Int32, Int32)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, System::String ^ arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, string arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, string? arg1, int arg2, int arg3);
member this.WriteEvent : int * string * int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Integer, arg3 As Integer)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- String
文字列引数。
- arg2
- Int32
32 ビット整数引数。
- arg3
- Int32
32 ビット整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int64, Int64, Int64)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 64 ビットの引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, long arg1, long arg2, long arg3);
protected void WriteEvent (int eventId, long arg1, long arg2, long arg3);
member this.WriteEvent : int * int64 * int64 * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Long, arg3 As Long)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int64
64 ビット整数引数。
- arg2
- Int64
64 ビット整数引数。
- arg3
- Int64
64 ビット整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int32, Int32, Int32)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, int arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, int arg1, int arg2, int arg3);
member this.WriteEvent : int * int * int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As Integer, arg3 As Integer)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int32
整数引数。
- arg2
- Int32
整数引数。
- arg3
- Int32
整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, String, String)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, System::String ^ arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, string arg1, string arg2);
protected void WriteEvent (int eventId, string? arg1, string? arg2);
member this.WriteEvent : int * string * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- String
文字列引数。
- arg2
- String
文字列引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, String, Int64)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, System::String ^ arg1, long arg2);
protected void WriteEvent (int eventId, string arg1, long arg2);
protected void WriteEvent (int eventId, string? arg1, long arg2);
member this.WriteEvent : int * string * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Long)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- String
文字列引数。
- arg2
- Int64
64 ビット整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, String, Int32)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, System::String ^ arg1, int arg2);
protected void WriteEvent (int eventId, string arg1, int arg2);
protected void WriteEvent (int eventId, string? arg1, int arg2);
member this.WriteEvent : int * string * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Integer)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- String
文字列引数。
- arg2
- Int32
32 ビット整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int64, String)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 64 ビット整数および文字列引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, long arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, long arg1, string arg2);
protected void WriteEvent (int eventId, long arg1, string? arg2);
member this.WriteEvent : int * int64 * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As String)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int64
64 ビット整数引数。
- arg2
- String
文字列引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, string arg2)
{
base.WriteEvent(2, arg1, arg2);
}
適用対象
WriteEvent(Int32, Int64, Int64)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 64 ビットの引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, long arg1, long arg2);
protected void WriteEvent (int eventId, long arg1, long arg2);
member this.WriteEvent : int * int64 * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Long)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int64
64 ビット整数引数。
- arg2
- Int64
64 ビット整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int32, Int32)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, int arg1, int arg2);
protected void WriteEvent (int eventId, int arg1, int arg2);
member this.WriteEvent : int * int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As Integer)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int32
整数引数。
- arg2
- Int32
整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(int arg1, int arg2, int arg3)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int32, String)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 32 ビット整数および文字列引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, int arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, int arg1, string arg2);
protected void WriteEvent (int eventId, int arg1, string? arg2);
member this.WriteEvent : int * int * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As String)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int32
32 ビット整数引数。
- arg2
- String
文字列引数。
適用対象
WriteEvent(Int32, String)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, System::String ^ arg1);
protected void WriteEvent (int eventId, string arg1);
protected void WriteEvent (int eventId, string? arg1);
member this.WriteEvent : int * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- String
文字列引数。
例
次の例は、このメソッド オーバーロードを使用してイベントを書き込む方法を示しています。 このコード例は、EventSource クラスのために提供されている大規模な例の一部です。
[Event(1, Message = "Application Failure: {0}", Level = EventLevel.Error, Keywords = Keywords.Diagnostic)]
public void Failure(string message) { WriteEvent(1, message); }
<[Event](1, Message:="Application Failure: {0}", Level:=EventLevel.Error, Keywords:=Keywords.Diagnostic)> _
Public Sub Failure(ByVal message As String)
WriteEvent(1, message)
End Sub
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Object[])
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と引数の配列を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, ... cli::array <System::Object ^> ^ args);
protected void WriteEvent (int eventId, params object[] args);
protected void WriteEvent (int eventId, params object?[] args);
member this.WriteEvent : int * obj[] -> unit
Protected Sub WriteEvent (eventId As Integer, ParamArray args As Object())
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- args
- Object[]
オブジェクトの配列。
注釈
既定では、呼び出しのパラメーターが他のメソッド オーバーロードの 1 つと一致しない場合、コンパイラはこのオーバーロードを呼び出します。 このオーバーロードは、次の処理を行うため、他のオーバーロードよりもはるかに遅くなります。
変数引数を保持する配列を割り当てます。
各パラメーターを オブジェクトにキャストします (これにより、プリミティブ型の割り当てが発生します)。
これらのオブジェクトが配列に割り当てられます。
関数を呼び出し、ETW に対してシリアル化できるように各引数の型を決定します。
メソッドはプロバイダーが有効になっている場合にのみ使用されるため、このオーバーロードのオーバーヘッドが大きいことは、ボリュームの少ないイベントをトレースする場合には重要ではありません。 ただし、大量のイベントの場合、パフォーマンスのオーバーヘッドが大きくなる可能性があります。 メソッドを使用して新しい高速なオーバーロードWriteEventCoreを作成することで、大量のペイロードに を使用EventSource.WriteEventしないようにできます。
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int64)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 64 ビット整数引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, long arg1);
protected void WriteEvent (int eventId, long arg1);
member this.WriteEvent : int * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int64
64 ビット整数引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int32)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, int arg1);
protected void WriteEvent (int eventId, int arg1);
member this.WriteEvent : int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int32
整数引数。
例
次の例は、このメソッド オーバーロードを使用してイベントを書き込む方法を示しています。 このコード例は、EventSource クラスのために提供されている大規模な例の一部です。
[Event(4, Opcode = EventOpcode.Stop, Task = Tasks.Page, Keywords = Keywords.Page, Level = EventLevel.Informational)]
public void PageStop(int ID) { if (IsEnabled()) WriteEvent(4, ID); }
<[Event](4, Opcode:=EventOpcode.Stop, Task:=Tasks.Page, Keywords:=Keywords.Page, Level:=EventLevel.Informational)> _
Public Sub PageStop(ByVal ID As Integer)
If IsEnabled() Then
WriteEvent(4, ID)
End If
End Sub
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(int arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, EventSource+EventSourcePrimitive[])
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子と、イベント ソース プリミティブの可変数を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId, ... cli::array <System::Diagnostics::Tracing::EventSource::EventSourcePrimitive> ^ args);
protected void WriteEvent (int eventId, params System.Diagnostics.Tracing.EventSource.EventSourcePrimitive[] args);
member this.WriteEvent : int * System.Diagnostics.Tracing.EventSource.EventSourcePrimitive[] -> unit
Protected Sub WriteEvent (eventId As Integer, ParamArray args As EventSource.EventSourcePrimitive())
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
イベント ソース プリミティブ。
注釈
これは、イベントを記述するための varargs ヘルパーです。 配列が作成され、すべての引数がボックス化されるため、比較的非効率的であり、比較的まれなイベント (1 秒あたり 100 未満など) にのみ使用する必要があります。 レートがそれより速い場合は、 を使用 WriteEventCore(Int32, Int32, EventSource+EventData*) して、特定のメソッド シグネチャの高速ヘルパーを作成します。 まれなイベントにこれを使用する場合でも、EventSource がアクティブでないときに varargs 呼び出しが行われないように、この呼び出しはチェックによってIsEnabled()保護する必要があります。
適用対象
WriteEvent(Int32, Byte[])
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子とバイト配列引数を使用してイベントを書き込みます。
protected:
void WriteEvent(int eventId, cli::array <System::Byte> ^ arg1);
protected void WriteEvent (int eventId, byte[] arg1);
protected void WriteEvent (int eventId, byte[]? arg1);
member this.WriteEvent : int * byte[] -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Byte())
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Byte[]
バイト配列引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(byte[] arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32)
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定されたイベント識別子を使用して、イベントを書き込みます。
protected:
void WriteEvent(int eventId);
protected void WriteEvent (int eventId);
member this.WriteEvent : int -> unit
Protected Sub WriteEvent (eventId As Integer)
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
例
次の例は、このメソッド オーバーロードを使用してイベントを書き込む方法を示しています。 このコード例は、EventSource クラスのために提供されている大規模な例の一部です。
[Event(1, Message = "Application Failure: {0}", Level = EventLevel.Error, Keywords = Keywords.Diagnostic)]
public void Failure(string message) { WriteEvent(1, message); }
<[Event](1, Message:="Application Failure: {0}", Level:=EventLevel.Error, Keywords:=Keywords.Diagnostic)> _
Public Sub Failure(ByVal message As String)
WriteEvent(1, message)
End Sub
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
適用対象
WriteEvent(Int32, Int64, Byte[])
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
- ソース:
- EventSource.cs
指定した識別子と 64 ビット整数およびバイト配列引数を使用して、イベント データを書き込みます。
protected:
void WriteEvent(int eventId, long arg1, cli::array <System::Byte> ^ arg2);
protected void WriteEvent (int eventId, long arg1, byte[] arg2);
protected void WriteEvent (int eventId, long arg1, byte[]? arg2);
member this.WriteEvent : int * int64 * byte[] -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Byte())
パラメーター
- eventId
- Int32
イベント識別子。 有効値の範囲は 0 ~ 65535 です。
- arg1
- Int64
64 ビット整数引数。
- arg2
- Byte[]
バイト配列引数。
注釈
eventid
は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。
派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。
[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, Byte[] arg2)
{
base.WriteEvent(2, arg1, arg2);
}
適用対象
.NET