이 설명서는 보관되지만 유지 되지 않습니다.

FrameworkElement.FindName 메서드

업데이트: 2007년 11월

제공된 식별자 이름이 지정된 요소를 찾습니다.

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

public Object FindName(
	string name
)
public Object FindName(
	String name
)
public function FindName(
	name : String
) : Object
XAML에서 메서드를 사용할 수 없습니다.

매개 변수

name
형식: System.String

요청된 요소의 이름입니다.

반환 값

형식: System.Object

요청된 요소입니다. 일치하는 요소를 찾을 수 없으면 null일 수 있습니다.

이 요소에 자식 요소가 있으면 명명된 요청 요소에 대해 이러한 자식 요소를 재귀적으로 모두 검색합니다.

FindName은 현재 요소의 이름 범위 내에서 작동합니다. 자세한 내용은 WPF 이름 범위를 참조하십시오.

이 예제에서는 FindName 메서드를 사용하여 Name 값으로 요소를 찾는 방법을 설명합니다.

이 예제에서는 특정 요소를 이름으로 찾는 메서드를 단추의 이벤트 처리기로 작성합니다. stackPanel은 검색할 루트 FrameworkElementName 입니다. 그런 다음 예제 메서드에서는 찾은 요소를 TextBlock으로 캐스팅하고 TextBlock의 시각적 UI 속성 중 하나를 변경하여 시각적으로 나타냅니다.

void Find(object sender, RoutedEventArgs e)
{
    object wantedNode = stackPanel.FindName("dog");
    if (wantedNode is TextBlock)
    {
        // Following executed if Text element was found.
        TextBlock wantedChild = wantedNode as TextBlock;
        wantedChild.Foreground = Brushes.Blue;
    }
}


전체 샘플을 보려면 요소 검색 샘플을 참조하십시오.

Windows Vista

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

.NET Framework

3.5, 3.0에서 지원
표시: