Setter.Value Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Ruft den Wert ab, der auf die Eigenschaft angewendet werden soll, die vom Setter angegeben wird, oder legt diesen fest.

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"/>

Eigenschaftswert

Object

Platform::Object

IInspectable

Der Wert, der auf die Eigenschaft angewendet werden soll, die vom Setter angegeben wird.

Hinweise

Wie Sie in der XAML-Syntax sehen können, gibt es verschiedene Möglichkeiten, den Wert für einen Setter in XAML anzugeben:

• Als Attribut unter Verwendung eines Zeichenfolgenwerts. Ein solcher Zeichenfolgenwert kann implizit in einen eigenschaftsspezifischen Typ für einfache Fälle konvertiert werden, z. B. für das Festlegen numerischer Werte, benannter Werte aus einer Enumeration oder eines Uniform Resource Identifier (URI).
• Als vollständiges neues Objekt, das in der Syntax des XAML-Objektelements deklariert ist, und das Objektelement wird in einer Eigenschaftselementverwendung geschachtelt.
• Als Attribut, das eine {StaticResource}-Markuperweiterungsverwendung innerhalb der Anführungszeichen aufweist. In der Regel gibt der Werttyp der Eigenschaft vor, welche Syntax geeignet ist. Weitere Informationen zu XAML-Verwendungen finden Sie unter XAML-Übersicht oder XAML-Syntaxhandbuch. Sie können die Attributsyntax für die meisten XAML-Ui-Eigenschaften verwenden, und UI-Eigenschaften, die speziell eine Eigenschaftenelementnutzung oder einen Ressourcenverweis erfordern, sind seltener. Eine {StaticResource}-Markuperweiterungsverwendung kann auch für Zeichenfolgen oder numerische Werte geeignet sein, wenn diese Werte von mehr als einer Formatvorlage oder Eigenschaft gemeinsam verwendet werden.

Sie müssen sowohl die Eigenschaft als auch die Value-Eigenschaft für einen Setter angeben. Andernfalls wird eine Ausnahme ausgelöst (entweder eine Analyseausnahme oder ein Laufzeitfehler, je nachdem, ob der Setter in XAML erstellt oder im Code geändert wird).

Wenn Sie mithilfe von Code auf einen Setter-instance zugreifen, können Sie den Wert einer Eigenschaft eines Setter-instance nicht ändern, wenn der Wert der IsSealed-Eigenschaft in einem übergeordneten Stiltrue ist. Dies wird auch von der IsSealed-Eigenschaft für einen einzelnen Setter gemeldet. Das System legt diese Eigenschaften auf true fest, wenn die Runtime Stile auf Benutzeroberflächenelemente anwendet und sie auf der Benutzeroberfläche anzeigt. Beim Versuch, einen versiegelten Setter zu ändern, wird ein Laufzeitfehler ausgelöst.

Stile und Vorlagen

Sie können einen Setter in einem Style verwenden, um Werte auf jede Abhängigkeitseigenschaft anzuwenden. Es ist jedoch der Setter für die Template-Eigenschaft einer von Control abgeleiteten Klasse, die den Großteil des XAML-Markups in einem typischen Style darstellt. Der Wert für einen Setter mit Property="Template" wird fast immer als Eigenschaftselement angegeben, das ein ControlTemplate-Objektelement enthält.

Wenn ein Style verwendet wird, um eine Steuerelementvorlage zu definieren, sollten der TargetType des Style-Elements und der TargetType des ControlTemplate-Elements für seinen Control.Template-Setter immer den gleichen Wert verwenden.

Der Vorlagensetter definiert die grundlegende Vorlagen-UI-Definition für ein Steuerelement instance, an dem diese Vorlage angewendet wird. Es enthält auch die visuellen Zustände für ein Steuerelement und andere zustandsbasierte UI-Definitionen, z. B. Standarddesignübergänge. Bei einem komplexen Steuerelement wie ListBox können die Standardvorlage Style und die ControlTemplate darin Hunderte von XAML-Zeilen aufweisen. Weitere Informationen zur Rolle von Style in Steuerelementvorlagenszenarien finden Sie unter Schnellstart: Steuerelementvorlagen.