Binding.Source Eigenschaft

Referenz

Definition

Namespace:: Windows.UI.Xaml.Data

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft die Datenquelle für die Bindung ab oder legt sie fest.

public:
 property Platform::Object ^ Source { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable Source();

void Source(IInspectable value);

public object Source { get; set; }

var object = binding.source;
binding.source = object;

Public Property Source As Object

<Binding Source="sourceReference"/>

Eigenschaftswert

Object

Platform::Object

IInspectable

Das Quellobjekt, das die Daten für die Bindung enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Eigenschaft in XAML festgelegt wird. Eine vollständige Codeauflistung finden Sie im XAML-Datenbindungsbeispiel.

<StackPanel>

  <StackPanel.Resources>
    <CollectionViewSource x:Name="teamsCVS"/>
  </StackPanel.Resources>

  <ListBox x:Name="lbTeams" Height="200" 
    ItemsSource="{Binding Source={StaticResource teamsCVS}}">
    <ListBox.ItemTemplate>
      <DataTemplate><!-- ... --></DataTemplate>
    </ListBox.ItemTemplate>
  </ListBox>

</StackPanel>

Ein Beispiel für das Festlegen dieser Eigenschaft im Code finden Sie in der Binding-Klasse .

Hinweise

Die Source-Eigenschaft ist für ein Binding-Objekt optional. Wenn die Source-Eigenschaft für ein Binding-Objekt festgelegt ist, gilt die Datenquelle nur für die Zieleigenschaften, die dieses Binding-Objekt verwenden.

Um eine Datenquelle zu erstellen, die von allen untergeordneten Elementen in der Struktur geerbt wird, legen Sie stattdessen die DataContext-Eigenschaft für das übergeordnete Element fest. Anschließend sehen das übergeordnete Element und alle untergeordneten Elemente den DataContext als Quelle ihrer Bindungen an. Wenn source für ein untergeordnetes Element festgelegt ist, wird die DataContext-Vererbung in diesem instance überschrieben.

Das Ziel kann direkt an das Source-Objekt gebunden werden, wenn der Pfad leer ist, oder an eine Eigenschaft des Source-Objekts, wie durch den Pfad definiert. Der Pfad wird entweder in XAML mit der Bindungssyntax oder beim Erstellen des Binding-Objekts festgelegt.

Sie können die Eigenschaftswerte eines Binding-Objekts nicht festlegen, nachdem diese Bindung an ein Zielelement und eine Zieleigenschaft angefügt wurde. Wenn Sie dies versuchen, erhalten Sie eine Laufzeit-Ausnahme.

Gilt für: