RelativeSource 標記延伸

指定RelativeSource繫結來源的屬性，以便在 Binding 標記延伸中使用，或在 XAML 中設定Binding元素的RelativeSource屬性時使用。

XAML Attribute Usage

<Binding RelativeSource="{RelativeSource modeEnumValue}" ... />

XAML 屬性使用方式 (以巢狀方式置於 Binding 延伸內)

<object property="{Binding RelativeSource={RelativeSource modeEnumValue} ...}" ... />

XAML 物件項目用法

<Binding>
  <Binding.RelativeSource>
    <RelativeSource Mode="modeEnumValue"/>
  </Binding.RelativeSource>
</Binding>

-或-

<Binding>
  <Binding.RelativeSource>
    <RelativeSource
      Mode="FindAncestor"
      AncestorType="{x:Type typeName}"
      AncestorLevel="intLevel"
    />
  </Binding.RelativeSource>
</Binding>

XAML 值

備註

{RelativeSource TemplatedParent} 繫結使用方式是一項重要技術，能夠處理區分控制項 UI 及控制項邏輯的大概念。 這可讓您從樣板定義內繫結到樣板化父代 (套用該樣板的執行階段物件執行個體)。 在這種情況下， TemplateBinding 標記延伸其實是下面繫結運算式的簡寫：{Binding RelativeSource={RelativeSource TemplatedParent}}。 TemplateBinding 或 {RelativeSource TemplatedParent} 使用方式都只在定義範本的 XAML 中相關。 更多詳細資訊，請參閱 TemplateBinding 標記延伸。

{RelativeSource FindAncestor} 主要用於控制項範本或可預測的獨立 UI 組合中，例如像是特定上階類型的視覺化樹狀結構中一律需要控制項的情況。 例如，項目控制項的項目可能會使用 FindAncestor 使用方法以繫結至其項目控制項父代的屬性。 或者，樣板中屬於控制項組合的項目也可以使用 FindAncestor 繫結至同一個組合結構中的父代項目。

在＜XAML 語法＞章節內顯示之 FindAncestor 模式的物件項目語法中，第二種物件項目語法特別適用於 FindAncestor 模式。 FindAncestor 模式需要 AncestorType 值。 您必須使用要尋找的上階類型的 x:Type 標記延伸參考，將 AncestorType 設為屬性。 在執行階段處理繫結要求時，會使用 AncestorType 值。

對於 FindAncestor 模式來說，當該類型在項目樹狀結構中可能存在一個以上的上階時，選擇性屬性 AncestorLevel 將有助於釐清上階查閱。

如需關於如何使用 FindAncestor 模式的詳細資訊，請參閱 RelativeSource。

如果執行個體的其中一個屬性依賴於同一個執行個體另一個屬性的值，且這兩個屬性之間並沒有存在一般性的相依性屬性關係 (例如強制型轉)，此時就適合使用 {RelativeSource Self}。 雖然物件的兩個屬性很少會有完全一樣的值 (並且是相同類型)，但您也可以將 Converter 參數套用至含有 {RelativeSource Self} 的繫結，並使用轉換器來轉換來源和目標類型。 另一種 {RelativeSource Self} 的情況是做為 MultiDataTrigger 的一部分。

例如，下面 XAML 會定義 Rectangle 項目，使得無論為 Width 輸入的值為何，Rectangle 永遠都是正方形：<Rectangle Width="200" Height="{Binding RelativeSource={RelativeSource Self}, Path=Width}" .../>

{RelativeSource PreviousData} 適用於資料範本，或者繫結是使用集合做為資料來源的情況。 您可以使用 {RelativeSource PreviousData} 來醒目提示集合中相鄰資料項目之間的關聯性。 還有一個相關的技術，就是在資料來源中的目前和先前項目之間建立 MultiBinding，並在該繫結上使用轉換器來判斷這兩個項目及其屬性之間的不同。

在下面範例中，項目範本中的第一個 TextBlock 會顯示目前的號碼。 第二個 TextBlock 繫結是 MultiBinding，這名義上會有兩個 Binding 組成部分：目前的記錄，以及一個特意透過 {RelativeSource PreviousData} 使用上一筆資料記錄的繫結。 然後，MultiBinding 上的轉換器會計算差異，並將它傳回給繫結。

<ListBox Name="fibolist">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
            <TextBlock Text="{Binding}"/>
            <TextBlock>, difference = </TextBlock>
                <TextBlock>
                    <TextBlock.Text>
                        <MultiBinding Converter="{StaticResource DiffConverter}">
                            <Binding/>
                            <Binding RelativeSource="{RelativeSource PreviousData}"/>
                        </MultiBinding>
                    </TextBlock.Text>
                </TextBlock>
            </StackPanel>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

這裡將不說明資料繫結的概念，另請參閱 資料繫結概觀。

在 WPF XAML 處理器實作中，這個標記延伸的處理是由 RelativeSource 類別所定義。

RelativeSource 是一種標記延伸。 如果必須將屬性 (Attribute) 值加上逸出符號，以免成為常值或處理常式名稱，而且這個動作必須更全面地實施 (而不是只對特定類型或屬性 (Property) 設定類型轉換子 (Type Converter))，則通常會實作標記延伸。 所有 XAML 標記延伸都會在其屬性語法中使用 { 與 } 字元，這個慣例讓 XAML 處理器知道某個標記延伸必須處理這個屬性。 如需詳細資訊，請參閱標記延伸和 WPF XAML。

另請參閱

• Binding
• 設定樣式和範本
• WPF 中的 XAML
• 標記延伸和 WPF XAML
• 資料繫結概觀
• 繫結宣告概觀
• x:Type 標記延伸模組