ContentElement.RemoveHandler(RoutedEvent, Delegate) Yöntem

Tanım

Belirtilen yönlendirilmiş olay işleyicisini bu öğeden kaldırır.

public:
 virtual void RemoveHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);
public void RemoveHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);
abstract member RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
Public Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)

Parametreler

routedEvent
RoutedEvent

İşleyicinin eklendiği.routed olayının tanımlayıcısı.

handler
Delegate

Bu öğedeki olay işleyicisi koleksiyonundan kaldırılacak belirli işleyici uygulaması.

Uygulamalar

Açıklamalar

Bu API'yi kullanmaya yönelik en yaygın senaryo, özel yönlendirilmiş bir olayla ilişkili ortak dil çalışma zamanı (CLR) "sarmalayıcı" olayını uyguladığınızda, özellikle de CLR düzeyinde işleyiciler için "kaldır" mantığını uyguladığınızda gerçekleşir. Bu açıklamalar bölümünü izleyen örnekte bu senaryo gösterilmektedir.

Yöntem çağrısının giriş parametreleriyle eşleşen ölçütlerle kaydedilmiş işleyiciler yoksa bu yöntemi çağırmanın hiçbir etkisi olmaz.

Ölçütle eşleşen birden fazla işleyici eklenmişse, yalnızca olay işleyici deposundaki ilk işleyici kaldırılır. Bu davranış, işlecin CLR davranışıyla -= tutarlıdır.

Ne routedEvent olabilir ne de handler olabilir null. her null iki değeri de sağlama girişimi bir özel durum oluşturur.

Bu yöntem, işleyici önceden işlenen olayların işlenmesine olanak tanıyan imza ile AddHandler(RoutedEvent, Delegate, Boolean) eklendiğinde sağlanan parametre bilgilerini yoksayarhandledEventsToo. her iki işleyici türü de kaldırılır.

Şunlara uygulanır

Ayrıca bkz.