Setter.Value 屬性

定義

命名空間:

Windows.UI.Xaml

取得或設定要套用至 Setter所指定之屬性的值。

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

IInspectable Value();

void Value(IInspectable value);

public object Value { get; set; }

var object = setter.value;
setter.value = object;

Public Property Value As Object

<Setter ...>
  <Setter.Value>
    objectValue
  </Setter.Value>
</Setter>
- or -
<Setter Value="attributeValue"/>
-or-
<Setter Value="extensionUsage"/>

屬性值

Object

Platform::Object

IInspectable

要套用至 Setter所指定之屬性的值。

備註

如您在 XAML 語法中所見，有多種方式可在 XAML 中指定 Setter 的值：

• 做為屬性，使用字串值。 這類字串值可以隱含地轉換成屬性特定的類型，例如設定數值、列舉中的具名值，或統一資源識別項 (URI) 。
• 作為在 XAML 物件專案語法中宣告的完整新物件，而且物件專案會巢狀于屬性元素使用方式內。
• 做為在引號內具有 {StaticResource} 標記延伸 用法的屬性。 屬性的實值型別通常會指定適當的語法。 如需 XAML 使用方式的詳細資訊，請參閱 XAML 概觀 或 XAML 語法指南。 您可以將屬性語法用於大部分的 XAML UI 屬性，以及特別需要屬性元素使用方式或資源參考的 UI 屬性較不常見。 如果這些值是由多個樣式或屬性共用， 則 {StaticResource} 標記延伸 用法甚至適用于字串或數值。

您必須在Setter上同時指定Property和 Value 屬性。 否則會擲回例外狀況 (剖析例外狀況或執行時間錯誤，視 Setter 是在 XAML 中建立或修改的程式碼) 而定。

如果您使用程式碼存取Setter實例，如果父Style上的IsSealed屬性值為 true，就無法變更Setter實例的任何屬性值。 這是由個別Setter上的IsSealed屬性所報告。 當執行時間將樣式套用至 UI 元素並在 UI 中顯示樣式時，系統會將這些屬性設定為 true 。 嘗試變更密封 的 Setter 會擲回執行階段錯誤。

樣式及範本

您可以使用Style中的Setter，將值套用至任何相依性屬性。 但它是Control衍生類別之Template屬性的Setter，其構成一般Style中大部分的 XAML 標記。 Setter的 Property="Template" Value 幾乎一律指定為包含ControlTemplate物件元素的屬性專案。

使用Style來定義控制項範本時，Style元素的TargetType及其Control.Template setter的 ControlTemplate元素TargetType應該一律使用相同的值。

Template setter 會定義套用該範本之控制項實例的基本範本 UI 定義。 它也包含控制項的視覺狀態，以及其他以狀態為基礎的 UI 定義，例如預設主題轉換。 對於 ListBox之類的複雜控制項，內的預設範本 Style 和 ControlTemplate 可以有數百行 XAML。 如需控制項範本化案例中 Style 角色的詳細資訊，請參閱 快速入門：控制項範本。