EventSource.WriteEvent メソッド

定義

指定されたイベント識別子と省略可能な引数を使用して、イベントを書き込みます。

オーバーロード

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, string arg1, string arg2, string arg3);
protected void WriteEvent (int eventId, string? arg1, string? arg2, string? arg3);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, String, Int32, Int32)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, string arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, string? arg1, int arg2, int arg3);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int64, Int64, Int64)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 64 ビットの引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, long arg1, long arg2, long arg3);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int32, Int32, Int32)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, int arg1, int arg2, int arg3);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, String, String)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, string arg1, string arg2);
protected void WriteEvent (int eventId, string? arg1, string? arg2);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, String, Int64)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, string arg1, long arg2);
protected void WriteEvent (int eventId, string? arg1, long arg2);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, String, Int32)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, string arg1, int arg2);
protected void WriteEvent (int eventId, string? arg1, int arg2);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int64, String)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 64 ビット整数および文字列引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, long arg1, string arg2);
protected void WriteEvent (int eventId, long arg1, string? arg2);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int64, Int64)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 64 ビットの引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, long arg1, long arg2);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int32, Int32)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, int arg1, int arg2);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int32, String)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 32 ビット整数および文字列引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, int arg1, string arg2);
protected void WriteEvent (int eventId, int arg1, string? arg2);

パラメーター

eventId
Int32

イベント識別子。 有効値の範囲は 0 ~ 65535 です。

arg1
Int32

32 ビット整数引数。

arg2
String

文字列引数。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, String)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と文字列引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, string arg1);
protected void WriteEvent (int eventId, string? arg1);

パラメーター

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); }

注釈

eventid は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Object[])

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と引数の配列を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, params object[] args);
protected void WriteEvent (int eventId, params object?[] args);

パラメーター

eventId
Int32

イベント識別子。 有効値の範囲は 0 ~ 65535 です。

args
Object[]

オブジェクトの配列。

注釈

既定では、呼び出しのパラメーターが他のメソッド オーバーロードの 1 つと一致しない場合、コンパイラはこのオーバーロードを呼び出します。 このオーバーロードは、次の処理を行うため、他のオーバーロードよりもはるかに遅くなります。

  1. 変数引数を保持する配列を割り当てます。

  2. 各パラメーターを オブジェクトにキャストします (これにより、プリミティブ型の割り当てが発生します)。

  3. これらのオブジェクトが配列に割り当てられます。

  4. 関数を呼び出し、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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int64)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 64 ビット整数引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, long arg1);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int32)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と 32 ビット整数引数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, int arg1);

パラメーター

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); }

注釈

eventid は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。

[Event(2, Level = EventLevel.Informational)]
public void Info1(int  arg1)
{
    base.WriteEvent(2, arg1);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, EventSource+EventSourcePrimitive[])

ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子と、イベント ソース プリミティブの可変数を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId, params System.Diagnostics.Tracing.EventSource.EventSourcePrimitive[] args);

パラメーター

eventId
Int32

イベント識別子。 有効値の範囲は 0 ~ 65535 です。

args
EventSource.EventSourcePrimitive[]

イベント ソース プリミティブ。

注釈

これは、イベントを記述するための varargs ヘルパーです。 配列が作成され、すべての引数がボックス化されるため、比較的非効率的であり、比較的まれなイベント (1 秒あたり 100 未満など) にのみ使用する必要があります。 レートがそれより速い場合は、 を使用 WriteEventCore(Int32, Int32, EventSource+EventData*) して、特定のメソッド シグネチャの高速ヘルパーを作成します。 まれなイベントにこれを使用する場合でも、EventSource がアクティブでないときに varargs 呼び出しが行われないように、この呼び出しはチェックによってIsEnabled()保護する必要があります。

適用対象

.NET 9 および .NET 8
製品 バージョン
.NET 8, 9

WriteEvent(Int32, Byte[])

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子とバイト配列引数を使用してイベントを書き込みます。

protected void WriteEvent (int eventId, byte[] arg1);
protected void WriteEvent (int eventId, byte[]? arg1);

パラメーター

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);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32)

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定されたイベント識別子を使用して、イベントを書き込みます。

protected void WriteEvent (int eventId);

パラメーター

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); }

注釈

eventid は 0 より大きいか、65535 未満である必要があります。または、操作でエラーが発生する可能性があります。 エラーが発生した場合、デバッガーがイベントを発生させるプロセスにアタッチされている場合は、デバッガーの出力ストリームを確認することで、エラーの原因に関する詳細情報を取得できます。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

派生クラスで ETW イベントとして識別されるメソッドを EventSource実装する場合。 次の例のような実装されたメソッドと同じ引数とを渡す基底クラス WriteEvent メソッドを呼び出す EventId 必要があります。

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteEvent(Int32, Int64, Byte[])

ソース:
EventSource.cs
ソース:
EventSource.cs
ソース:
EventSource.cs

指定した識別子と 64 ビット整数およびバイト配列引数を使用して、イベント データを書き込みます。

protected void WriteEvent (int eventId, long arg1, byte[] arg2);
protected void WriteEvent (int eventId, long arg1, byte[]? arg2);

パラメーター

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 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0