DependencyProperty.Register 메서드

정의

네임스페이스:

Windows.UI.Xaml

속성에 대해 지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 종속성 속성을 등록합니다. 등록된 종속성 속성을 소유할 DependencyObject 파생 클래스를 정의하거나 초기화할 때 이 메서드를 사용합니다.

 static DependencyProperty Register(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& typeMetadata);

public static DependencyProperty Register(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata typeMetadata);

function register(name, propertyType, ownerType, typeMetadata)

Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata) As DependencyProperty

매개 변수

name

String

winrt::hstring

등록할 종속성 속성의 이름입니다.

propertyType

TypeName Type

형식 참조로 속성의 형식입니다(Microsoft .NET용 System.Type , Visual C++ 구성 요소 확장용 TypeName 도우미 구조체(C++/CX)).

ownerType

TypeName Type

종속성 속성을 형식 참조로 등록하는 소유자 형식입니다(Microsoft .NET용 System.Type , Visual C++ 구성 요소 확장용 TypeName 도우미 구조체(C++/CX)).

typeMetadata

PropertyMetadata

속성 메타데이터 instance. 여기에는 기본값 및 PropertyChangedCallback 구현 참조가 포함될 수 있습니다. 이 매개 변수에 대한 전달 null 은 PropertyMetadata.Createnull 를 기본값 매개 변수로 호출하여 만든 새 PropertyMetadata instance 전달하는 것과 같습니다.

반환

DependencyProperty

종속성 속성 식별자는 일반적으로 DependencyObject 파생 클래스의 공용 정적 읽기 전용 필드에 저장됩니다. 그런 다음 식별자는 사용자 고유의 코드와 타사 사용자 코드 모두에서 나중에 종속성 속성을 참조하는 데 사용되며, 프로그래밍 방식으로 값을 설정하거나 코드에서 바인딩 을 연결하는 등의 작업에 사용됩니다.

설명

사용자 지정 종속성 속성을 등록하는 방법은 사용자 지정 종속성 속성 항목에 자세히 설명되어 있습니다(예제 포함).

종속성 속성 등록은 일반적으로 앱이 처음 시작되거나 앱 코드에서 정의한 DependencyObject 파생 클래스가 처음 사용되는 경우에만 수행하는 작업입니다. 앱 수명 초기에 종속성 속성을 등록하여 앱의 다른 코드와 XAML이 등록 및 사용 가능하기 전에 종속성 속성을 사용하지 않도록 해야 합니다. 정확한 등록 방법과 시기는 프로그래밍 언어에 따라 달라집니다. C# 또는 Microsoft Visual Basic의 경우 종속성 속성을 소유하는 클래스의 정적 클래스 초기화 중에 종속성 속성을 등록하는 것이 일반적입니다. 이렇게 하면 instance 초기화하는 코드 또는 XAML이 해당 정적 생성을 호출하고 종속성 속성을 등록합니다. Visual C++ 구성 요소 확장(C++/CX)의 경우 정적 클래스 초기화는 사용 가능한 기술이 아니므로 일반적으로 애플리케이션 개체 초기화의 일부로 앱에서 사용하려는 모든 사용자 지정 종속성 속성을 등록하는 앱 전체 도우미 메서드를 정의해야 합니다. Visual C++ 구성 요소 확장(C++/CX)에 필요한 몇 가지 특수 기술을 포함하여 사용자 지정 종속성 속성을 등록하는 방법과 시기의 예는 사용자 지정 종속성 속성을 참조하세요.

추가 정보

• 사용자 지정 종속성 속성
• 종속성 속성 개요
• XAML 사용자 및 사용자 지정 컨트롤 샘플