FrameworkContentElement.DataContext Propriedade

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

Valor de Propriedade

O objeto a usar como contexto de dados.

Atributos

LocalizabilityAttribute

Exemplos

O exemplo seguinte estabelece uma ligação num Paragraph elemento, criando um novo objeto de dados personalizado, estabelecendo esse objeto como DataContext, e definindo o caminho de ligação para uma propriedade dentro dele.

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")

Observações

O contexto de dados é um conceito que permite aos elementos herdar informação dos seus elementos pais sobre a fonte de ligação utilizada para a ligação, bem como outras características da ligação, como o caminho.

O contexto de dados pode ser definido diretamente para um objeto de runtime de linguagem comum (CLR), com as ligações a avaliar as propriedades desse objeto. Alternativamente, podes definir o contexto dos dados para um DataSourceProvider objeto.

Esta propriedade de dependência herda os valores da propriedade. Se existirem elementos filhos sem outro valor para DataContext estabelecido através de valores ou estilos locais, o sistema de propriedades definirá o valor para ser o DataContext valor do elemento pai mais próximo com esse valor atribuído.

Em alternativa, pode usar uma das seguintes propriedades da Binding classe para especificar explicitamente a fonte de ligação: ElementName, Source, ou RelativeSource. Para mais informações, veja Como: Especificar a Fonte de Ligação.

Em XAML, DataContext é mais frequentemente definido como uma Binding declaração. Pode usar sintaxe de elementos de propriedade ou de atributos. A sintaxe dos atributos é mostrada no exemplo desta página. Também podes definir DataContext o código.

Uso do elemento de propriedade XAML

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

Uso de atributos XAML

<object DataContext="bindingUsage"/>

-ou-

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

Valores XAML

dataContextObject Um objeto diretamente embutido que serve como contexto de dados para quaisquer ligações dentro do elemento pai. Normalmente, este objeto é uma Binding ou outra BindingBase subclasse. Alternativamente, os dados brutos de qualquer tipo de objeto CLR destinado à ligação podem ser colocados aqui, com as ligações reais definidas posteriormente.

bindingUtilização Um uso de binding que avalia para um contexto de dados apropriado. Para mais detalhes, veja Binding Markup Extension.

resourceExtension Um dos seguintes: StaticResource, ou DynamicResource. Esta utilização é usada ao referir-se a dados brutos definidos como um objeto em recursos. Consulte Recursos XAML.

contextResourceKey O identificador de chave para o objeto solicitado dentro de um ResourceDictionary.

Informação de Propriedade de Dependência