FrameworkContentElement.DataContext Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta il contesto dati per un elemento quando partecipa al data binding.

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

Valore della proprietà

Object

Oggetto da utilizzare come contesto dati.

Attributi

LocalizabilityAttribute

Esempio

Nell'esempio seguente viene impostata un'associazione su un Paragraph elemento creando un nuovo oggetto dati personalizzato, stabilendo tale oggetto come DataContexte impostando il percorso di associazione su una proprietà al suo interno.

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

Commenti

Il contesto dei dati è un concetto che consente agli elementi di ereditare informazioni dai relativi elementi padre sull'origine di associazione usata per l'associazione, nonché altre caratteristiche dell'associazione, ad esempio il percorso.

Il contesto dei dati può essere impostato direttamente su un oggetto CLR (Common Language Runtime), con le associazioni che valutano le proprietà di tale oggetto. In alternativa, è possibile impostare il contesto dati su un DataSourceProvider oggetto .

Questa proprietà di dipendenza eredita i valori delle proprietà. Se sono presenti elementi figlio senza alcun altro valore per DataContext stabilito tramite valori o stili locali, il sistema di proprietà imposta il valore DataContext come valore dell'elemento padre più vicino con questo valore assegnato.

In alternativa, è possibile usare una delle proprietà seguenti della Binding classe per specificare l'origine di associazione in modo esplicito: ElementName, Sourceo RelativeSource. Per altre informazioni, vedere Procedura: Specificare l'origine dell'associazione.

In XAML, DataContext è più comunemente impostato su come Binding dichiarazione. È possibile usare la sintassi dell'elemento proprietà o la sintassi degli attributi. La sintassi degli attributi è illustrata nell'esempio in questa pagina. È anche possibile impostare DataContext nel codice.

Utilizzo dell'elemento della proprietà XAML

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

Utilizzo degli attributi XAML

<object DataContext="bindingUsage"/>

oppure

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

Valori XAML

dataContextObject Oggetto incorporato direttamente che funge da contesto dati per qualsiasi associazione all'interno dell'elemento padre. In genere, questo oggetto è una Binding o un'altra BindingBase sottoclasse. In alternativa, i dati non elaborati di qualsiasi tipo di oggetto CLR destinato all'associazione possono essere inseriti qui, con le associazioni effettive definite in un secondo momento.

bindingUsage Utilizzo dell'associazione che restituisce un contesto dati appropriato. Per informazioni dettagliate, vedere Binding Markup Extension.

resourceExtension Uno dei seguenti: StaticResourceo DynamicResource. Questo utilizzo viene usato quando si fa riferimento a dati non elaborati definiti come oggetto nelle risorse. Vedi Risorse XAML.

contextResourceKey Identificatore di chiave per l'oggetto richiesto dall'interno di un oggetto ResourceDictionary.

Informazioni sulle proprietà di dipendenza

Item	Value
Campo Identificatore	DataContextProperty
Proprietà dei metadati impostate su true	Inherits