FrameworkContentElement.DataContext 속성

정의

데이터 바인딩에 참여할 때 요소의 데이터 컨텍스트를 가져오거나 설정합니다.

public:
 property System::Object ^ DataContext { System::Object ^ get(); void set(System::Object ^ value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public object DataContext { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.DataContext : obj with get, set
Public Property DataContext As Object

속성 값

데이터 컨텍스트로 사용할 개체입니다.

특성

예제

다음은 새 사용자 지정 데이터 개체를 Paragraph 만들고 해당 개체를 해당 개체로 DataContext설정하고 바인딩 경로를 해당 속성으로 설정하여 요소에 대한 바인딩을 설정하는 예제입니다.

MyData myDataObject = new MyData();
myflowdocument.DataContext = myDataObject;
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData");
Dim myDataObject As New MyData()
myflowdocument.DataContext = myDataObject
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData")

설명

데이터 컨텍스트 는 요소가 바인딩에 사용되는 바인딩 원본에 대한 부모 요소의 정보와 경로와 같은 바인딩의 다른 특성을 상속할 수 있도록 하는 개념입니다.

데이터 컨텍스트는 CLR(공용 언어 런타임) 개체로 직접 설정할 수 있으며 바인딩은 해당 개체의 속성으로 평가됩니다. 또는 데이터 컨텍스트를 개체로 DataSourceProvider 설정할 수 있습니다.

이 종속성 속성은 속성 값을 상속합니다. 로컬 값이나 스타일을 통해 설정할 다른 값 DataContext 이 없는 자식 요소가 있는 경우 속성 시스템은 이 값 DataContext 이 할당된 가장 가까운 부모 요소의 값으로 값을 설정합니다.

또는 클래스의 Binding 다음 속성 중 하나를 사용하여 바인딩 소스를 명시적으로 ElementNameSourceRelativeSource지정할 수 있습니다. 자세한 내용은 방법: 바인딩 원본 지정을 참조하세요.

XAML DataContext 에서 가장 일반적으로 선언으로 Binding 설정됩니다. 속성 요소 구문 또는 특성 구문을 사용할 수 있습니다. 특성 구문은 이 페이지의 예제에 나와 있습니다. 코드에서 설정할 DataContext 수도 있습니다.

XAML 속성 요소 사용

<object>
  <object.DataContext>
    <dataContextObject />
  </object.DataContext>
</object>

XAML 특성 사용

<object DataContext="bindingUsage"/>

-또는-

<object DataContext="{resourceExtension contextResourceKey}"/>

XAML 값

dataContextObject 부모 요소 내의 모든 바인딩에 대한 데이터 컨텍스트 역할을 하는 직접 포함된 개체입니다. 일반적으로 이 개체는 Binding 다른 BindingBase 하위 클래스입니다. 또는 바인딩을 위한 CLR 개체 형식의 원시 데이터를 여기에 배치할 수 있으며, 실제 바인딩은 나중에 정의됩니다.

bindingUsage 적절한 데이터 컨텍스트로 평가되는 바인딩 사용법입니다. 자세한 내용은 Binding 태그 확장을 참조하세요.

resourceExtension 다음 중 하나: StaticResource또는 DynamicResource. 이 사용법은 리소스에서 개체로 정의된 원시 데이터를 참조할 때 사용됩니다. XAML 리소스를 참조하세요.

contextResourceKey 에서 요청되는 개체의 키 식별자입니다 ResourceDictionary.

종속성 속성 정보

Item Value
식별자 필드 DataContextProperty
메타데이터 속성이 다음으로 설정됩니다. true Inherits

적용 대상