다음을 통해 공유


StaticResource 태그 확장

이미 정의된 리소스에 대한 참조를 조회하여 모든 XAML 속성 특성에 대한 값을 제공합니다. 해당 리소스에 대한 조회 동작은 로드 시간 조회와 유사합니다. 이 조회는 현재 XAML 페이지 및 다른 애플리케이션 원본의 태그에서 이전에 로드된 리소스를 찾고 해당 리소스 값을 런타임 개체의 속성 값으로 생성합니다.

XAML 특성 사용

<object property="{StaticResource key}" ... />  

XAML 개체 요소 사용

<object>  
  <object.property>  
<StaticResource ResourceKey="key" ... />  
  </object.property>  
</object>  

XAML 값

설명
key 요청한 리소스의 키입니다. 이 키는 태그에서 리소스가 만들어진 경우 x:Key 지시문에 의해 처음에 할당되었거나 코드에서 리소스가 만들어진 경우 ResourceDictionary.Add를 호출할 때 key 매개 변수로 제공되었습니다.

설명

중요

StaticResource는 XAML 파일 내에서 구문적으로 더 정의된 리소스에 대한 전방 참조를 만들려고 해서는 안 됩니다. 이렇게 하려는 시도는 지원되지 않으며, 이러한 참조가 실패하지 않더라도 전방 참조를 시도하면 ResourceDictionary를 나타내는 내부 해시 테이블을 검색할 때 로드 시간 성능 저하가 발생합니다. 최상의 결과를 얻으려면 전방 참조를 피할 수 있도록 리소스 사전의 컴퍼지션을 조정합니다. 전방 참조를 피할 수 없는 경우 DynamicResource 태그 확장을 대신 사용합니다.

지정된 ResourceKey는 페이지, 애플리케이션, 사용 가능한 컨트롤 테마 및 외부 리소스 또는 시스템 리소스의 특정 수준에서 x:Key 지시문으로 식별되는 기존 리소스에 해당해야 합니다. 리소스 조회는 해당 순서대로 수행됩니다. 정적 및 동적 리소스에 대한 리소스 조회 동작에 대한 자세한 내용은 XAML 리소스를 참조하세요.

리소스 키는 XamlName 문법에 정의된 문자열일 수 있습니다. 리소스 키는 Type과 같은 다른 개체 형식일 수도 있습니다. Type 키는 암시적 스타일 키를 통해 테마별로 컨트롤의 스타일을 지정하는 방법에 대한 기본 사항입니다. 자세한 내용은 컨트롤 제작 개요를 참조하세요.

리소스를 참조하는 대체 선언적 방법은 DynamicResource 태그 확장입니다.

특성 구문은 이러한 태그 확장에 가장 많이 사용되는 구문입니다. StaticResource 식별자 문자열 다음에 나오는 문자열 토큰은 기본 ResourceKey 확장명 클래스의 StaticResourceExtension 값으로 할당됩니다.

StaticResource는 개체 요소 구문에서 사용될 수도 있습니다. 이 경우 ResourceKey 속성의 값을 지정해야 합니다.

StaticResource 속성을 다음과 같이 속성=값 쌍으로 지정하는 자세한 특성 사용 구문에도 ResourceKey을 사용할 수 있습니다.

<object property="{StaticResource ResourceKey=key}" ... />  

자세한 정보 표시는 대개 설정 가능한 속성이 둘 이상이거나 일부 속성이 선택 사항인 확장의 경우에 유용합니다. StaticResource에는 설정 가능한 속성이 하나뿐이고 이 속성은 필수적 속성이므로 자세한 정보 표시를 사용하지 않는 것이 일반적입니다.

WPF XAML 프로세서 구현에서 이 태그 확장에 대한 처리는 StaticResourceExtension 클래스를 통해 정의됩니다.

StaticResource은 태그 확장입니다. 태그 확장은 특성 값을 리터럴 값 또는 처리기 이름이 아닌 다른 값이 되도록 이스케이프해야 하는 요구 사항이 있는 경우 일반적으로 구현되며 이러한 요구 사항은 특정 형식 또는 속성에 형식 변환기를 배치하는 것보다 더 포괄적입니다. XAML의 모든 태그 확장은 특성 구문에 { 및 } 문자를 사용하며, 여기서 특성 구문은 XAML 프로세서가 태그 확장이 특성을 처리해야 함을 인식하는 데 사용하는 규칙입니다. 자세한 내용은 태그 확장 및 WPF XAML을 참조하세요.

참고 항목