Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

FrameworkContentElement.DataContext Property

Gets or sets the data context for an element when it participates in data binding. This is a dependency property.

Namespace: System.Windows
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

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

/** @property */
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  A directly embedded object that serves as data context for any bindings within the parent element. Typically, this object is a Binding or another BindingBase subclass. Alternatively, raw data of any CLR object type intended for binding may be placed here, with the actual bindings defined later.  bindingUsage  A binding usage that evaluates to an appropriate data context. For details, see Binding Markup Extension.  resourceExtension  One of the following: StaticResource, or DynamicResource. This usage is used when referring to raw data defined as an object in resources. See Resources Overview.  contextResourceKey  The key identifier for the object being requested from within a ResourceDictionary. 

Property Value

The object to use as data context.

Identifier field

DataContextProperty

Metadata properties set to true

Inherits

Data context is a concept that allows elements to inherit information from their parent elements about the binding source that is used for binding, as well as other characteristics of the binding such as the path.

Data context can be set directly to a common language runtime (CLR) object, with the bindings evaluating to properties of that object. Alternatively, you can set the data context to a DataSourceProvider object.

This dependency property inherits property values. If there are child elements with no other value for DataContext established through local values or styles, the property system will set the value to be the DataContext value of the nearest parent element with this value assigned.

Alternatively, you can use one of the following properties of the Binding class to specify the binding source explicitly: ElementName, Source, or RelativeSource. For more information, see How to: Specify the Binding Source.

In XAML, DataContext is most commonly set to as a Binding declaration. You can use either property element syntax or attribute syntax. Attribute syntax is shown in the example on this page. You can also set DataContext in code.

The following example sets a binding on a Paragraph element, by creating a new custom data object, establishing that object as DataContext, and setting the binding path to a property within it.

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

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.