문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

UIElement.RemoveHandler 메서드

UIElement에서 지정한 라우팅된 이벤트 처리기를 제거합니다.

네임스페이스:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)

public void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)

매개 변수

routedEvent
형식: System.Windows.RoutedEvent
처리기가 연결된 라우팅된 이벤트의 식별자입니다.
handler
형식: System.Delegate
UIElement의 이벤트 처리기 컬렉션에서 제거할 특정 처리기 구현입니다.

예외상황
ArgumentNullException

routedEvent 또는 handlernull입니다.

ArgumentException

routedEvent가 지원되는 라우팅된 이벤트를 나타내지 않습니다.

- 또는 -

handler가 지원되는 대리자를 구현하지 않습니다.

NotImplementedException

현재 플랫폼 변형에서 지원하지 않는 이벤트에 대해 처리기를 제거하려고 시도했습니다.

중요중요:

RemoveHandler AddHandler에서 지원되는 이벤트의 이벤트 처리기에만 사용할 수 있습니다. 언어별 이벤트 연결 구문(예: C#의 +=)이나 XAML의 이벤트 특성을 사용하여 추가된 일반 이벤트에 대한 처리기를 제거하는 데 RemoveHandler를 사용할 수는 없습니다. 대신 언어별 이벤트 처리기 연결 끊기/제거 구문(예: C#의 -=)을 이러한 이벤트 처리기에 사용해야 합니다.

메서드 호출의 입력 매개 변수와 일치하는 조건으로 등록된 처리기가 없으면 이 메서드를 호출해도 아무런 영향이 없습니다.

조건에 일치하는 처리기가 여러 개 연결되어 있으면 이벤트 처리기 저장소의 첫 번째 처리기만 제거됩니다. 이 동작은 -= 연산자의 CLR 동작과 일치합니다.

routedEventhandler는 모두 null이 될 수 없습니다. 이 두 값을 null로 제공하려고 하면 예외가 발생합니다.

이 메서드는 대칭 AddHandler 호출의 handledEventsToo 매개 변수 정보를 무시합니다.

버전 메모

Silverlight 3: 위의 설명에서 언급 모든 이벤트를 Silverlight 3에서 사용할 수 있는 것은 아닙니다. Silverlight 3은 오른쪽 클릭 이벤트, 조작/터치 이벤트, 끌기/놓기 이벤트 또는 IME 지원 이벤트는 지원하지 않습니다. Silverlight 3에서 이에 대한 처리기를 추가하거나 제거하려고 시도하면 ArgumentException가 throw됩니다.

Silverlight

5, 4, 3에서 지원

Windows Phone용 Silverlight

Windows Phone OS 7.1, Windows Phone OS 7.0에서 지원

Silverlight에서 지원되는 운영 체제 및 브라우저에 대한 자세한 내용은 지원되는 운영 체제 및 브라우저을 참조하십시오.

커뮤니티 추가 항목

추가
표시: