UIElement.RaiseEvent(RoutedEventArgs) メソッド


特定のルーティング イベントを発生させます。Raises a specific routed event. 発生する RoutedEvent は、提供された RoutedEventArgs インスタンス内で識別されます (そのイベント データの RoutedEvent プロパティとして)。The RoutedEvent to be raised is identified within the RoutedEventArgs instance that is provided (as the RoutedEvent property of that event data).

 virtual void RaiseEvent(System::Windows::RoutedEventArgs ^ e);
public void RaiseEvent (System.Windows.RoutedEventArgs e);
abstract member RaiseEvent : System.Windows.RoutedEventArgs -> unit
override this.RaiseEvent : System.Windows.RoutedEventArgs -> unit
Public Sub RaiseEvent (e As RoutedEventArgs)



イベント データを格納し、発生するイベントを識別する RoutedEventArgsA RoutedEventArgs that contains the event data and also identifies the event to raise.


次の例では、イベントデータを作成し、イベント識別子をデータに追加した後、イベントデータインスタンスを使用してカスタムルーティングイベントを発生させます。The following example creates event data, appends the event identifier to the data, and then uses the event data instance to raise a custom routed event.

void RaiseTapEvent()
        RoutedEventArgs newEventArgs = new RoutedEventArgs(MyButtonSimple.TapEvent);
Private Sub RaiseTapEvent()
    Dim newEventArgs As New RoutedEventArgs(MyButtonSimple.TapEvent)
End Sub


e パラメーターは、すべてのルーティングイベントデータの共通基本型として型指定されます。ただし、イベントデータは、発生したイベントに対して使用できる最も具体的なイベントデータ型として指定する必要があります。これは RoutedEventArgs 派生クラスに、発生時に特定のイベントを想定した実際のデータプロパティが含まれているためです。The e parameter is typed as the common base type for all routed event data; however, the event data should be given as the most specific event data type that is available for the event being raised, because RoutedEventArgs derived classes contain the actual specific data properties that are intended for the specific event when it is raised.

RoutedEventArgs は、イベントの状態プロパティではありません。また、どのルーティングイベントを発生させるかも識別します。RoutedEventArgs is not just the state properties for the event; it also identifies which routed event to raise. このイベント発生パターンとルーティングイベントデータはどちらも、イベントに関連するプロパティだけを含む 共通言語ランタイム (CLR)common language runtime (CLR) イベントとデータクラスとは異なります。This event-raising pattern and the routed event data both differ from 共通言語ランタイム (CLR)common language runtime (CLR) events and data classes, which typically just contain properties that are related to the event.