다음을 통해 공유


DependencyProperty.RegisterAttached 메서드

정의

속성 시스템에 연결된 속성을 등록합니다.

오버로드

RegisterAttached(String, Type, Type)

지정된 속성 이름, 속성 형식 및 소유자 유형을 사용하여 연결된 속성을 등록합니다.

RegisterAttached(String, Type, Type, PropertyMetadata)

지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터에 연결된 속성을 등록합니다.

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

속성에 대해 지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 값 유효성 검사 콜백에 연결된 속성을 등록합니다.

RegisterAttached(String, Type, Type)

지정된 속성 이름, 속성 형식 및 소유자 유형을 사용하여 연결된 속성을 등록합니다.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType);
public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType);
static member RegisterAttached : string * Type * Type -> System.Windows.DependencyProperty
Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type) As DependencyProperty

매개 변수

name
String

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

propertyType
Type

속성의 형식입니다.

ownerType
Type

종속성 속성을 등록하는 소유자 유형입니다.

반환

DependencyProperty

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

예제

다음 예제에서는이 사용 하 여 추상 클래스에 연결된 된 속성 등록 RegisterAttached 서명 합니다.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}
Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

설명

연결된 속성은 XAML(Extensible Application Markup Language)에서 정의한 속성 개념입니다. WPF는 연결된 속성을 종속성 속성으로 구현합니다. WPF 연결 속성은 종속성 속성이므로 일반 속성 시스템에서 레이아웃 특성 보고와 같은 작업에 사용할 수 있는 메타데이터를 적용할 수 있습니다. 자세한 내용은 연결된 속성 개요를 참조하세요.

종속성 속성 등록에 대 한 자세한 내용은 참조 하세요. DependencyProperty합니다.

추가 정보

적용 대상

RegisterAttached(String, Type, Type, PropertyMetadata)

지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터에 연결된 속성을 등록합니다.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata);
public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata);
static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyProperty
Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyProperty

매개 변수

name
String

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

propertyType
Type

속성의 형식입니다.

ownerType
Type

종속성 속성을 등록하는 소유자 유형입니다.

defaultMetadata
PropertyMetadata

종속성 속성의 속성 메타데이터입니다. 여기에는 기본값뿐만 아니라 다른 특성도 포함될 수 있습니다.

반환

DependencyProperty

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

설명

연결된 속성은 XAML(Extensible Application Markup Language)에서 정의한 속성 개념입니다. WPF는 연결된 속성을 종속성 속성으로 구현합니다. WPF 연결 속성은 종속성 속성이므로 일반 속성 시스템에서 레이아웃 특성 보고와 같은 작업에 사용할 수 있는 메타데이터를 적용할 수 있습니다. 자세한 내용은 연결된 속성 개요를 참조하세요.

종속성 속성 등록에 대 한 자세한 내용은 참조 하세요. DependencyProperty합니다.

종속성 속성 값 상속을 사용 하 여 RegisterAttached

특정 시나리오 중 하나 사용 하 여 종속성 속성을 등록할 RegisterAttached 대신 Register 속성 값 상속을 지원 하는 것입니다. 사용 하 여 종속성 속성 값 상속을 등록 해야 RegisterAttached 클래스는 종속성 속성을 노출 하는 속성 래퍼 접근자를 정의 하는 경우에 및 숨기지 않으려면 제공 하는 Get * 및 집합 * 정적 메서드를 노출 하려면 true를 연결 하는 경우에 접근자 지원 합니다. 속성 값 상속은 연결 되지 않은 종속성 속성에 대 한 작업에 표시 될 수 있지만 런타임 트리의 특정 요소 경계를 통해 연결 되지 않은 속성에 대 한 상속 동작은 정의 되지 않습니다. 효과적으로 연결 속성을 등록 속성 시스템에 연결된 된 속성이 전역 속성으로 설정 및 속성 값 상속은 요소 트리에서 모든 경계에 걸쳐 작동 하는 보장 합니다. 항상 사용 하 여 RegisterAttached 지정 하는 속성을 등록 하려면 Inherits 메타 데이터에서입니다. 자세한 내용은 속성 값 상속을 참조하세요.

추가 정보

적용 대상

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

속성에 대해 지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 값 유효성 검사 콜백에 연결된 속성을 등록합니다.

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);
public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata, System.Windows.ValidateValueCallback validateValueCallback);
static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyProperty
Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata, validateValueCallback As ValidateValueCallback) As DependencyProperty

매개 변수

name
String

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

propertyType
Type

속성의 형식입니다.

ownerType
Type

종속성 속성을 등록하는 소유자 유형입니다.

defaultMetadata
PropertyMetadata

종속성 속성의 속성 메타데이터입니다. 여기에는 기본값뿐만 아니라 다른 특성도 포함될 수 있습니다.

validateValueCallback
ValidateValueCallback

일반적인 형식 유효성 검사 이외에 종속성 속성 값의 사용자 지정 유효성 검사를 수행하는 콜백에 대한 참조입니다.

반환

DependencyProperty

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

예제

다음 예제에서는이 사용 하 여 추상 클래스에 연결된 된 속성 등록 RegisterAttached 서명 합니다. 이 연결 된 속성에는 열거 형식 속성은 및 등록 과정에서 제공 된 값이 열거형의 값 임을 확인 하려면 유효성 검사 콜백을 추가 합니다.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}
Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

설명

연결된 속성은 XAML(Extensible Application Markup Language)에서 정의한 속성 개념입니다. WPF는 연결된 속성을 종속성 속성으로 구현합니다. WPF 연결 속성은 종속성 속성이므로 일반 속성 시스템에서 레이아웃 특성 보고와 같은 작업에 사용할 수 있는 메타데이터를 적용할 수 있습니다. 자세한 내용은 연결된 속성 개요를 참조하세요.

종속성 속성 등록에 대 한 자세한 내용은 참조 하세요. DependencyProperty합니다.

종속성 속성 값 상속을 사용 하 여 RegisterAttached

특정 시나리오 중 하나 사용 하 여 종속성 속성을 등록할 RegisterAttached 대신 Register 속성 값 상속을 지원 하는 것입니다. 사용 하 여 종속성 속성 값 상속을 등록 해야 RegisterAttached 클래스는 종속성 속성을 노출 하는 속성 래퍼 접근자를 정의 하는 경우에 및 숨기지 않으려면 제공 하는 Get * 및 집합 * 정적 메서드를 노출 하려면 true를 연결 하는 경우에 접근자 지원 합니다. 속성 값 상속은 연결 되지 않은 종속성 속성에 대 한 작업에 표시 될 수 있지만 런타임 트리의 특정 요소 경계를 통해 연결 되지 않은 속성에 대 한 상속 동작은 정의 되지 않습니다. 효과적으로 연결 속성을 등록 속성 시스템에 연결된 된 속성이 전역 속성으로 설정 및 속성 값 상속은 요소 트리에서 모든 경계에 걸쳐 작동 하는 보장 합니다. 항상 사용 하 여 RegisterAttached 지정 하는 속성을 등록 하려면 Inherits 메타 데이터에서입니다. 자세한 내용은 속성 값 상속을 참조하세요.

추가 정보

적용 대상