FrameworkContentElement.DataContext Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define o contexto de dados de um elemento quando ele participa da vinculação de dados.

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 da propriedade

Object

O objeto a ser usado como contexto de dados.

Atributos

LocalizabilityAttribute

Exemplos

O exemplo a seguir define uma associação em um Paragraph elemento, criando um novo objeto de dados personalizado, estabelecendo esse objeto como DataContexte definindo o caminho de associaçã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")

Comentários

O contexto de dados é um conceito que permite que os elementos herdem informações de seus elementos pai sobre a fonte de associação usada para associação, bem como outras características da associação, como o caminho.

O contexto de dados pode ser definido diretamente para um objeto CLR (common language runtime), com as associações avaliando as propriedades desse objeto. Como alternativa, você pode definir o contexto de dados como um DataSourceProvider objeto.

Essa propriedade de dependência herda valores de propriedade. Se houver elementos filho sem nenhum outro valor para DataContext estabelecido por meio de valores ou estilos locais, o sistema de propriedades definirá o valor como o DataContext valor do elemento pai mais próximo com esse valor atribuído.

Como alternativa, você pode usar uma das seguintes propriedades da Binding classe para especificar explicitamente a origem da associação: ElementName, Sourceou RelativeSource. Para obter mais informações, consulte Como especificar a origem da associação.

No XAML, DataContext é mais comumente definido como uma Binding declaração. Você pode usar a sintaxe do elemento de propriedade ou a sintaxe de atributo. A sintaxe do atributo é mostrada no exemplo nesta página. Você também pode definir DataContext no código.

Uso do elemento propriedade XAML

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

Uso do Atributo XAML

<object DataContext="bindingUsage"/>  

- ou -

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

Valores XAML

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

bindingUsage
Um uso de associação que é avaliado para um contexto de dados apropriado. Para ver os detalhes, consulte Extensão de marcação Binding.

resourceExtension
Um dos seguintes: StaticResource, ou DynamicResource. Esse uso é usado ao fazer referência a dados brutos definidos como um objeto em recursos. Consulte recursos XAML.

contextResourceKey
O identificador de chave para o objeto que está sendo solicitado de dentro de um ResourceDictionary.

Informações da propriedade de dependência

Campo identificador	DataContextProperty
Propriedades de metadados definidas como true	Inherits