FrameworkContentElement.Name 속성

정의

네임스페이스:

System.Windows

어셈블리:

PresentationFramework.dll

요소를 식별하는 이름을 가져오거나 설정합니다. 이 이름은 이벤트 처리기 코드와 같은 프로그래밍 방식 코드 숨김이 XAML 구문 분석 중에 생성된 후 요소를 참조할 수 있도록 인스턴스 참조를 제공합니다.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public string Name { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.Name : string with get, set

Public Property Name As String

속성 값

String

요소 이름입니다.

구현

Name

특성

LocalizabilityAttribute

설명

이 속성의 가장 일반적인 사용법은 태그에서 XAML 요소 이름을 지정하는 경우입니다.

이 속성은 기본적으로 XAML x:Name 지시문을 설정하는 WPF 프레임워크 수준 편의 속성을 제공합니다.

코드에서 가져오는 Name 것은 일반적이지 않습니다. 코드에 적절한 참조가 이미 있는 경우 요소 참조에서 메서드 및 속성을 호출할 수 있으며 일반적으로 필요하지 Name않기 때문입니다. 예외는 문자열에 오버로드된 의미가 있는 경우입니다. 예를 들어 해당 이름을 UI에 표시하는 것이 유용한 경우입니다. Name 태그에서 원본 Name 이 설정된 경우 코드에서 설정하는 것도 권장되지 않으며 속성을 변경해도 개체 참조가 변경되지 않습니다. 이러한 개체 참조는 XAML 로드 중에 기본 이름 범위가 명시적으로 생성되는 경우에만 만들어집니다.

이미 로드된 요소의 속성을 효과적으로 변경 Name 하려면 구체적으로 호출 RegisterName 해야 합니다.

코드에서 설정 Name 이 중요한 한 가지 주목할 만한 경우는 스토리보드가 실행되는 요소의 이름을 지정하는 것입니다. 이름을 등록하기 전에 인스턴스를 인스턴스화하고 할당 NameScope 해야 할 수도 있습니다. 예제 섹션 또는 Storyboards 개요를 참조하세요.

설정 Name 에서 코드를 애플리케이션을 제한적 이지만 요소 이름별 조회 보다 일반적 위치 페이지 애플리케이션에 로드 하 고 런타임에 코드를 반드시 않습니다의 코드 숨김 탐색 모델을 사용 중인 경우에 특히 해당 페이지입니다. 모든 FrameworkContentElement요소에서 사용할 수 있는 유틸리티 메서드FindName는 해당 요소 Name 의 논리 트리에서 재귀적으로 요소를 찾을 수 있습니다. 또는 문자열을 FindLogicalNode 인수로 사용하는 정적 메서드 LogicalTreeHelper를 Name 사용할 수 있습니다.

일반적으로 사용되는 루트 요소(WindowPage예: 인터페이스)는 구현INameScope합니다. 이 인터페이스의 구현은 해당 범위 내에서 이름이 모호하지 않게 적용해야 합니다.

종속성 속성 정보

식별자 필드	NameProperty
메타 데이터 속성 설정 true	IsAnimationProhibited

추가 정보

• NameScope