Setter.Value 屬性

定義

命名空間:

Microsoft.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 中指定 ValueSetter ：

• 做為屬性，使用字串值。 這類字串值可以隱含轉換成屬性特定的類型，例如設定數值、列舉中的具名值，或 (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，將值套用至任何相依性屬性。 但它是 SetterControl衍生類別的Template屬性，其構成一般 Style 中大部分的 XAML 標記。 Value Setter 的 Property="Template" ，幾乎一律指定為包含ControlTemplate物件元素的屬性專案。

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

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