x:Uid 지시어

마크업 요소에 대한 고유 식별자를 제공합니다. UWP(유니버설 Windows 플랫폼) XAML의 경우 이 고유 식별자는 .resw 리소스 파일의 리소스 사용과 같은 XAML 지역화 프로세스 및 도구에서 사용됩니다.

XAML 특성 사용

<object x:Uid="stringID".../>

XAML 값

비고

x:Uid를 사용하여 XAML에서 개체 요소를 식별합니다. 일반적으로 이 개체 요소는 컨트롤 클래스의 인스턴스이거나 UI에 표시되는 다른 요소입니다. x:Uid에서 사용하는 문자열과 리소스 파일에서 사용하는 문자열 간의 관계는 리소스 파일 문자열이 x:Uid 뒤에 점(.)이 뒤에 와 지역화되는 요소의 특정 속성 이름이라는 것입니다. 다음 예제를 고려하세요.

<Button x:Uid="GoButton" Content="Go"/>

표시 텍스트 Go를 바꿀 콘텐츠를 지정하려면 리소스 파일에서 제공되는 새 리소스를 지정해야 합니다. 리소스 파일에는 "GoButton.Content"라는 리소스에 대한 항목이 포함되어야 합니다. 이 경우 콘텐츠는 Button 클래스에서 상속하는 특정 속성입니다. 이 단추의 다른 속성에 지역화된 값을 제공할 수도 있습니다. 예를 들어 "GoButton.FlowDirection"에 대한 리소스 기반 값을 제공할 수 있습니다. x:Uid 및 리소스 파일을 함께 사용하는 방법에 대한 자세한 내용은 UI 및 앱 패키지 매니페스트에서 문자열 지역화를 참조하세요.

x:Uid 값에 사용할 수 있는 문자열의 유효성은 실제로 문자열이 리소스 파일 및 리소스 경로의 식별자로 유효한지 제어됩니다.

x:Uid 는 명시된 XAML 지역화 시나리오로 인해 x:Name 과 불연속적이므로 지역화에 사용되는 식별자는 x:Name의 프로그래밍 모델에 대한 종속성이 없습니다. 또한 x:Name 은 XAML 이름 범위 개념에 의해 제어되는 반면 x:Uid 의 고유성은 PRI(패키지 리소스 인덱스) 시스템에 의해 제어됩니다. 자세한 내용은 MRT Core 및 리소스 관리 시스템을 사용하여 리소스 관리를 참조하세요.

Windows 런타임 XAML에는 사용된 이전 XAML 사용 기술과 x :Uid 고유성에 대한 규칙이 약간 다릅니다. Window 런타임 XAML의 경우 동일한 x:Uid ID 값이 여러 XAML 요소에 대한 지시문으로 존재하는 것이 좋습니다. 그러나 이러한 각 요소는 리소스 파일에서 리소스를 확인할 때 동일한 해결 논리를 공유해야 합니다. 또한 프로젝트의 모든 XAML 파일은 x:Uid 해상도를 위해 단일 리소스 범위를 공유하며 x :Uid 범위는 개별 XAML 파일에 정렬되는 개념이 없습니다.

경우에 따라 PRI(패키지 리소스 인덱스) 시스템의 기본 제공 기능이 아닌 리소스 경로를 사용합니다. x:Uid 값으로 사용되는 모든 문자열은 ms-resource:///Resources/로 시작하고 x:Uid 문자열을 포함하는 리소스 경로를 정의합니다. 경로는 리소스 파일에서 지정하거나 대상으로 지정하는 속성의 이름으로 완료됩니다.

Windows 런타임 XAML에서 허용되지 않는 속성 요소에 x:Uid 를 배치하지 마세요.