x:Class 특성
업데이트: 2007년 11월
XAML 컴파일을 구성하여 태그와 코드 숨김 사이에 partial 클래스를 조인합니다. 코드 partial 클래스는 별도의 코드 파일에 CLS(공용 언어 사양) 언어로 정의되고 태그 partial 클래스는 XAML 컴파일 시 코드 생성을 통해 만들어집니다.
XAML 특성 사용
<object x:Class="namespace.classname"...>
...
</object>
XAML 값
namespace |
선택적 요소. classname으로 식별된 partial 클래스가 포함된 CLR 네임스페이스를 지정합니다. namespace를 지정하는 경우 점(.)으로 namespace와 classname을 분리합니다. |
classname |
필수 요소입니다. 로드된 XAML 및 해당 XAML의 코드 숨김을 연결하는 partial 클래스의 CLR 이름을 지정합니다. |
설명
x:Class는 XAML(Extensible Application Markup Language) 요소 트리의 루트이고 컴파일 중인 모든 요소(Page 빌드 작업이 있는 프로젝트에 XAML(Extensible Application Markup Language)이 포함된 경우)의 특성으로 선언하거나, 컴파일된 응용 프로그램의 응용 프로그램 정의에서 Application 루트의 특성으로 선언할 수 있습니다. x:Class를 페이지 루트 또는 응용 프로그램 루트 이외의 다른 요소에 선언하거나 XAML(Extensible Application Markup Language) 파일이 컴파일되지 않은 경우에 선언하면 컴파일 타임 오류가 발생합니다.
x:Class로 사용되는 클래스는 중첩된 클래스일 수 없습니다.
코드 숨김을 전혀 사용하지 않는 XAML 페이지를 만들 수 있다는 점에서는 x:Class가 선택 사항이지만 페이지에서 클래스 정의가 코드 숨김 클래스에 있는 사용자 지정 요소를 인스턴스화하거나 이벤트 처리 특성 값을 선언하는 경우에는 코드 숨김의 적절한 클래스에 대한 x:Class 참조 또는 x:Subclass가 반드시 필요합니다.
x:Class 특성의 값은 클래스의 정규화된 이름을 지정하는 문자열이어야 합니다. 간단한 응용 프로그램에서는 CLR 네임스페이스 정보를 생략할 수도 있는데 이는 코드 숨김에서도 구조가 동일한 경우, 즉 클래스 수준에서 정의가 시작되는 경우에만 가능합니다. 페이지 또는 응용 프로그램 정의에 대한 코드 숨김 파일은 컴파일된 응용 프로그램을 생성하는 프로젝트의 일부로 포함된 코드 파일에 들어 있어야 합니다. CLR 클래스의 명명 규칙을 따라야 합니다. 자세한 내용은 Type Definitions를 참조하십시오. 기본적으로 코드 숨김 클래스는 public이어야 하지만 x:ClassModifier 특성을 사용하여 다른 액세스 수준으로 정의할 수도 있습니다.
x:Class 특성 값이 갖는 이러한 의미는 WPF XAML 구현에만 적용됩니다. WPF 이외의 다른 XAML 구현에서는 관리 코드를 사용하지 않았을 수 있으므로 다른 클래스 확인 방법을 사용했을 수 있습니다.