이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
내보내기(0) 인쇄
모두 확장
이 문서는 수동으로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오.
번역
원본

DependencyProperty.Register 메서드 (String, Type, Type, PropertyMetadata)

지정된 속성 이름, 속성 형식, 소유자 형식 및 속성 메타데이터를 사용하여 종속성 속성을 등록합니다.

네임스페이스:  System.Windows
어셈블리:  WindowsBase(WindowsBase.dll)

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

매개 변수

name
형식: System.String
등록할 종속성 속성의 이름입니다.
propertyType
형식: System.Type
속성의 형식입니다.
ownerType
형식: System.Type
종속성 속성을 등록하는 소유자 유형입니다.
typeMetadata
형식: System.Windows.PropertyMetadata
종속성 속성의 속성 메타데이터입니다.

반환 값

형식: System.Windows.DependencyProperty
클래스에서 public static readonly 필드 값을 설정하기 위해 사용해야 하는 종속성 속성 식별자입니다. 해당 값을 프로그래밍 방식으로 설정하거나 메타데이터를 가져오는 등의 작업에서 나중에 종속성 속성을 참조하는 데 이 식별자가 사용됩니다.

종속성 속성 등록에 대한 자세한 내용은 DependencyProperty를 참조하십시오.

This example shows how to back a common language runtime (CLR) property with a DependencyProperty field, thus defining a dependency property. When you define your own properties and want them to support many aspects of Windows Presentation Foundation (WPF) functionality, including styles, data binding, inheritance, animation, and default values, you should implement them as a dependency property.

The following example first registers a dependency property by calling the Register method. The name of the identifier field that you use to store the name and characteristics of the dependency property must be the Name you chose for the dependency property as part of the Register call, appended by the literal string Property. For instance, if you register a dependency property with a Name of Location, then the identifier field that you define for the dependency property must be named LocationProperty.

In this example, the name of the dependency property and its CLR accessor is State; the identifier field is StateProperty; the type of the property is Boolean; and the type that registers the dependency property is MyStateControl.

If you fail to follow this naming pattern, designers might not report your property correctly, and certain aspects of property system style application might not behave as expected.

You can also specify default metadata for a dependency property. This example registers the default value of the State dependency property to be false.


public class MyStateControl : ButtonBase
{
  public MyStateControl() : base() { }
  public Boolean State
  {
    get { return (Boolean)this.GetValue(StateProperty); }
    set { this.SetValue(StateProperty, value); } 
  }
  public static readonly DependencyProperty StateProperty = DependencyProperty.Register(
    "State", typeof(Boolean), typeof(MyStateControl),new PropertyMetadata(false));
}


For more information about how and why to implement a dependency property, as opposed to just backing a CLR property with a private field, see 종속성 속성 개요.

.NET Framework

4, 3.5, 3.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows 7, Windows Vista SP1 이상, Windows XP SP3, Windows Server 2008(Server Core는 지원되지 않음), Windows Server 2008 R2(Server Core는 SP1 이상에서 지원됨), Windows Server 2003 SP2

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

커뮤니티 추가 항목

추가
표시:
© 2015 Microsoft