Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ContentElement.RaiseEvent Method

Raises a specific routed event. The RoutedEvent to be raised is identified within the RoutedEventArgs instance that is provided (as the RoutedEvent property of that event data).

Namespace: System.Windows
Assembly: PresentationCore (in presentationcore.dll)

public void RaiseEvent (
	RoutedEventArgs e
)
public final void RaiseEvent (
	RoutedEventArgs e
)
public final function RaiseEvent (
	e : RoutedEventArgs
)
You cannot use methods in XAML.

Parameters

e

A RoutedEventArgs that contains the event data and also identifies the event to raise.

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 is not just the state properties for the event; it also identifies which routed event to raise. This event-raising pattern and the routed event data both differ from common language runtime (CLR) events and data classes, which typically just contain properties that are related to the event.

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();
  newEventArgs.RoutedEvent = MyCustomLink.TapEvent;
  //newEvent.SetSource(this);
  RaiseEvent(newEventArgs);
}

More Code

How to: Create a Custom Routed Event

For your custom event to support event routing, you need to register a RoutedEvent using the RegisterRoutedEvent method. This example demonstrates the basics of creating a custom routed event.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft