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

FrameworkElement.Name 속성

 

게시 날짜: 2016년 11월

요소를 식별하는 이름을 가져오거나 설정합니다. 이 이름은 생성된 후 XAML 프로세서에서 처리하는 동안 이벤트 처리기 코드 등의 코드 숨김에서 태그 요소를 참조할 수 있도록 참조를 제공합니다.

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

[LocalizabilityAttribute(LocalizationCategory.NeverLocalize)]
public string Name { get; set; }

속성 값

Type: System.String

요소의 이름을 나타내며 기본값은 빈 문자열입니다.

지정 하는 것이 속성의 가장 일반적인 용도 XAML 태그에서 특성으로 요소 이름입니다.

이 속성에는 기본적으로 설정 하는 WPF 프레임 워크 수준 편의 속성은 제공 된 XAMLx:Name Directive합니다. 

이름은 이름 범위 내에서 고유 해야 합니다. 자세한 내용은 참조 WPF XAML 이름 범위합니다.

가져오기는 Name 에서 요소를 만드는 경우 코드는 일반적인 없습니다. 코드에 적절 한 참조가 이미 있는 경우 방금 메서드를 호출할 수 있습니다 및 요소에서 속성 참조는 일반적으로 필요 하지는 Name합니다. 이 예외가 발생 하는 경우는 Name 문자열에 오버 로드 된 의미가, 예를 들어 경우에서 이름을 표시 하는 것이 유용 UI합니다. 설정는 Name 코드 숨김 파일에서 하는 경우 원래 Name 태그에서 설정한은 또한 권장 되지 않으며, 로딩 후 속성을 변경는 XAML 원래 개체 참조를 변경 되지 것입니다. 개체 참조는 구문 분석 중에 기본 이름 범위를 명시적으로 만든 경우에 생성 됩니다. 명시적으로 호출 해야 RegisterName 확인에 대 한 효과적인 변경 하는 Name 이미 로드 된 요소의 속성입니다.

해야 하는 대표적인에서는 설정 경우 Name 코드에서 런타임 시 참조할 수 있도록 storyboard 요소를 실행에 대 한 이름을 등록할 때입니다. 이름을 등록할 수 있습니다, 전에 인스턴스화하고 할당 해야 할 수도 NameScope 인스턴스. 예 섹션을 참조 하거나 적기합니다.

설정 Name 코드에서 제한적으로 응용 프로그램, 하지만 여 요소를 가져오기 Name 이 더 일반적입니다. 하나의 특정 한 시나리오는 응용 프로그램은 여기서에 응용 프로그램 페이지가 다시 로드 하 고 런타임 코드는 반드시 해당 페이지에 대해 정의 된 코드 숨김 하지 탐색 모델을 지원 하는 경우입니다. 유틸리티 메서드 FindName에서 사용 하지 않는 FrameworkElement, 별로 모든 요소를 찾을 수 Name 해당 요소의 논리적 트리에서 필요에 따라 재귀적으로 트리를 검색 합니다. 또는 사용할 수 있습니다는 FindLogicalNode 의 정적 메서드 LogicalTreeHelper, 또한를 사용 하는 Name 인수로 문자열입니다.

일반적으로 사용 되는 루트 요소 (Window, Page 예를 들어) 인터페이스를 구현 INameScope합니다. 이 인터페이스의 구현 적용 이름이 해당 범위 내에서 모호한 것으로 예상 됩니다. 또한이 인터페이스를 정의 하는 루트 요소에는 모든의 이름 범위 동작 경계를 정의 하면 관련 API합니다.

Name 속성 다른 프로세스에 대 한 식별자 역할도 합니다. 예를 들어,는 WPF 자동화 모델에서 사용할 Name 클라이언트 및 공급자에 대 한 AutomationId로 합니다.

에 사용 되는 문자열 값 Name 내부에서 부여 된 몇 가지 제한이 x:Name Directive 정의한는 XAML 사양입니다. 가장 주목할 만한는 Name 는 문자 또는 밑줄 문자 (_)로 시작 해야 하며 문자, 숫자 또는 밑줄만 포함 해야 합니다. 자세한 내용은 참조 WPF XAML 이름 범위합니다.

Name 애니메이션을 적용할 수 있는 종속성 속성이 거의 중 하나입니다 (IsAnimationProhibitedtrue 메타 데이터에) 이름 자체는 애니메이션을 대상으로 하는 것에 대 한 중요 한 이기 때문에 있습니다. 데이터 바인딩은 Name 기술적으로 가능 하기 때문에 매우 드문 경우 이지만 데이터 바인딩된 Name 속성의 주요 용도 제공할 수 없습니다: 코드 숨김에 대 한 식별자 연결 지점을 제공 하기.

식별자 필드

NameProperty

로 메타 데이터 속성 설정true

IsAnimationProhibited

다음 예에서는 Name 코드에서 속성에서 이름을 새로 만든 범위로 다음 등록 하 고 NameScope 호출 하 여 RegisterName합니다. 여기에서 설명 하는 방법에는 스토리 보드 필요 하 여 대상으로 하기 때문에 스토리 보드를 사용한 애니메이션에 대 한 요구 사항은 Name, 및 개체 참조에 의해 대상으로 지정할 수 있습니다.

//  
// Create a Rectangle
//
Rectangle myRectangle = new Rectangle();
myRectangle.Width = 200;
myRectangle.Height = 200;
myRectangle.Name = "myRectangle";
this.RegisterName(myRectangle.Name, myRectangle); 

.NET Framework
3.0 이후 사용 가능
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능
맨 위로 이동
표시: