Binding.Source 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定綁定的資料來源。
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"/>
屬性值
包含綁定資料的來源物件。
範例
以下程式碼範例示範如何在 XAML 中設定此屬性。 完整程式碼列表請參閱 XAML 資料綁定範例。
<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>
若想示範如何在程式碼中設定此屬性,請參見 Binding 類別。
備註
Binding 物件的 Source 屬性是可選的。 如果 Source 屬性設定在綁 定 物件上,資料來源只會套用到使用該 綁定 物件的目標屬性。
若要建立一個由樹中所有子元素繼承的資料來源,請將 DataContext 屬性設定在父元素上。 接著父元素及其所有子元素會將 DataContext 視為綁定的來源。 如果 Source 設定為子元素,則會在該實例中覆寫 DataContext 的繼承。
如果路徑為空,目標可以直接綁定到來源物件,或綁定路徑定義的原始物件屬性。 路徑可透過 XAML 的綁定語法設定,或在建立 綁定 物件時設定。
在綁定物件綁定到目標元素和目標屬性後,你無法設定 該物件的 屬性值。 如果你嘗試這樣做,會遇到執行時例外。