이 설명서는 보관되지만 유지 되지 않습니다.

FrameworkElement.DataContext 속성

업데이트: 2007년 11월

요소가 데이터 바인딩에 관여되는 경우 해당 요소의 데이터 컨텍스트를 가져오거나 설정합니다. 이 속성은 종속성 속성입니다.

네임스페이스:  System.Windows
어셈블리:  PresentationFramework(PresentationFramework.dll)
XAML의 XMLNS: http://schemas.microsoft.com/winfx/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.NeverLocalize)]
public Object DataContext { get; set; }
/** @property */
/** @attribute LocalizabilityAttribute(LocalizationCategory.NeverLocalize) */
public Object get_DataContext()
/** @property */
/** @attribute LocalizabilityAttribute(LocalizationCategory.NeverLocalize) */
public  void set_DataContext(Object value)

public function get DataContext () : Object
public function set DataContext (value : Object)
<object>
  <object.DataContext>
    <dataContextObject />
  </object.DataContext>
</object>
<object DataContext="bindingUsage"/>
- or -
<object DataContext="{resourceExtension contextResourceKey}"/>
dataContextObject
                    부모 요소 내에서 모든 바인딩의 데이터 컨텍스트 역할을 하는 직접 포함된 개체입니다. 일반적으로 이 개체는 Binding 또는 다른 BindingBase 파생 클래스입니다. 바인딩에 사용할 CLR 개체 형식의 원시 데이터를 여기에 배치하고 실제 바인딩은 나중에 정의할 수도 있습니다.
                bindingUsage
                    적절한 데이터 컨텍스트로 사용되는 바인딩입니다. 자세한 내용은 Binding 태그 확장을 참조하십시오.
                resourceExtension StaticResource 또는 DynamicResource 중 하나입니다. 리소스에서 개체로 정의된 원시 데이터를 참조할 때 사용됩니다. 리소스 개요를 참조하십시오.
                contextResourceKey ResourceDictionary 내에서 요청된 개체의 키 식별자입니다.
                

속성 값

형식: System.Object

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

식별자 필드

DataContextProperty

true로 설정된 메타데이터 속성

Inherits

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

데이터 컨텍스트는 CLR(공용 언어 런타임) 개체의 속성인 바인딩을 사용하여 해당 개체에 직접 설정할 수 있습니다. 또는 DataSourceProvider 개체에 데이터 컨텍스트를 설정할 수도 있습니다.

이 종속성 속성은 속성 값을 상속합니다. 로컬 값 또는 스타일을 통해 DataContext에 대해 설정된 다른 값이 없는 자식 요소가 있으면 속성 시스템에서는 해당 값을 이 값이 할당된 가장 근접한 부모 요소의 DataContext 값으로 설정합니다.

또한 Binding 클래스의 ElementName, Source 또는 RelativeSource 속성 중 하나를 사용하여 바인딩 소스를 명시적으로 지정할 수도 있습니다. 자세한 내용은 방법: 바인딩 소스 지정을 참조하십시오.

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

DataContext는 특정 컨텍스트가 다른 컨텍스트에 바인딩될 수 있는 시나리오의 작업을 원활하게 수행할 수 있도록 바인딩 가능한 속성입니다. 그러나 DataContext에 바인딩하는 경우에는 순환 바인딩 참조를 만들지 않도록 주의해야 합니다. 즉, DataContext 속성은 속성 값 참조 특성을 가지기 때문에 DataContext를 자기 자신에 바인딩할 수 있지만, 이렇게 해서는 안 됩니다.

다음 예제에서는 데이터 컨텍스트가 바인딩에 대해 작동하며 바인딩된 속성의 특정 값을 정의하는 정보를 제공하는 방법을 보여 줍니다.

<Window.Resources>
  <src:LeagueList x:Key="MyList" />


...


</Window.Resources>


...


<DockPanel DataContext="{Binding Source={StaticResource MyList}}">


Windows Vista

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

.NET Framework

3.5, 3.0에서 지원
표시: