EventSource.WriteEvent メソッド

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

member this.WriteEvent : int * string * string * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String, arg3 As String)

パラメーター

注釈

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

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

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

protected:
 void WriteEvent(int eventId, System::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 は、0 より大きいか 65535 未満であるか、操作でエラーが発生する可能性があります。 エラーが発生した場合は、デバッガーの出力ストリームを確認することで、エラーの発生元に関する詳細情報を取得できます (デバッガーがイベントを発生させるプロセスにアタッチされている場合)。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

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

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

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

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

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

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

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

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

protected:
 void WriteEvent(int eventId, System::String ^ arg1, System::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 は、0 より大きいか 65535 未満であるか、操作でエラーが発生する可能性があります。 エラーが発生した場合は、デバッガーの出力ストリームを確認することで、エラーの発生元に関する詳細情報を取得できます (デバッガーがイベントを発生させるプロセスにアタッチされている場合)。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

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

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

protected:
 void WriteEvent(int eventId, System::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 は、0 より大きいか 65535 未満であるか、操作でエラーが発生する可能性があります。 エラーが発生した場合は、デバッガーの出力ストリームを確認することで、エラーの発生元に関する詳細情報を取得できます (デバッガーがイベントを発生させるプロセスにアタッチされている場合)。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

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

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

protected:
 void WriteEvent(int eventId, System::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 は、0 より大きいか 65535 未満であるか、操作でエラーが発生する可能性があります。 エラーが発生した場合は、デバッガーの出力ストリームを確認することで、エラーの発生元に関する詳細情報を取得できます (デバッガーがイベントを発生させるプロセスにアタッチされている場合)。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

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

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

protected:
 void WriteEvent(int eventId, long arg1, System::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 は、0 より大きいか 65535 未満であるか、操作でエラーが発生する可能性があります。 エラーが発生した場合は、デバッガーの出力ストリームを確認することで、エラーの発生元に関する詳細情報を取得できます (デバッガーがイベントを発生させるプロセスにアタッチされている場合)。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

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

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

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

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

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

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

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

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

protected:
 void WriteEvent(int eventId, int arg1, System::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)

パラメーター

protected:
 void WriteEvent(int eventId, System::String ^ arg1);

protected void WriteEvent(int eventId, string arg1);

member this.WriteEvent : int * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As 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 イベント ストリームで報告されたエラーを検索することもできます。

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

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

protected:
 void WriteEvent(int eventId, ... cli::array <System::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())

パラメーター

注釈

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

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

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

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

4. 関数を呼び出し、ETW 用にシリアル化できるように各引数の型を決定します。

このメソッドはプロバイダーが有効になっている場合にのみ使用されるため、このオーバーロードのオーバーヘッドが大きいことは、ボリュームの少ないイベントをトレースする場合には重要ではありません。 ただし、大量のイベントの場合、パフォーマンスのオーバーヘッドが大きくなる可能性があります。 EventSource.WriteEvent メソッドを使用して新しい高速なオーバーロードを作成することで、大量のペイロードにWriteEventCoreを使用しないようにすることができます。

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

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

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

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

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

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

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)

パラメーター

例

次の例は、このメソッドオーバーロードを使用してイベントを書き込む方法を示しています。 このコード例は、 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 イベント ストリームで報告されたエラーを検索することもできます。

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

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

protected:
 void WriteEvent(int eventId, cli::array <System::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 は、0 より大きいか 65535 未満であるか、操作でエラーが発生する可能性があります。 エラーが発生した場合は、デバッガーの出力ストリームを確認することで、エラーの発生元に関する詳細情報を取得できます (デバッガーがイベントを発生させるプロセスにアタッチされている場合)。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

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

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

protected:
 void WriteEvent(int eventId);

protected void WriteEvent(int eventId);

member this.WriteEvent : int -> unit

Protected Sub WriteEvent (eventId As Integer)

パラメーター

例

次の例は、このメソッドオーバーロードを使用してイベントを書き込む方法を示しています。 このコード例は、 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 イベント ストリームで報告されたエラーを検索することもできます。

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

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

protected:
 void WriteEvent(int eventId, long arg1, cli::array <System::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 は、0 より大きいか 65535 未満であるか、操作でエラーが発生する可能性があります。 エラーが発生した場合は、デバッガーの出力ストリームを確認することで、エラーの発生元に関する詳細情報を取得できます (デバッガーがイベントを発生させるプロセスにアタッチされている場合)。 エラーが発生したイベント ソースに ETW リスナーがある場合は、ETW イベント ストリームで報告されたエラーを検索することもできます。

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

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