Setter.Value Eigenschaft

Definition

Namespace:

Microsoft.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 anhand der XAML-Syntax sehen können, gibt es eine Vielzahl von Möglichkeiten, die Value für einen Setter in XAML anzugeben:

• Als Attribut mit einem Zeichenfolgenwert. Ein solcher Zeichenfolgenwert kann implizit in einen eigenschaftsspezifischen Typ konvertiert werden, z. B. für das Festlegen numerischer Werte, benannter Werte aus einer Enumeration oder eines URI (Uniform Resource Identifier).
• Als vollständiges neues Objekt, das in der XAML-Objektelementsyntax 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 zur XAML-Verwendung finden Sie unter XAML-Übersicht oder XAML-Syntaxleitfaden. Sie können Attributsyntax für die meisten XAML-UI-Eigenschaften verwenden, und UI-Eigenschaften, die speziell eine Eigenschaftenelementverwendung oder einen Ressourcenverweis erfordern, sind seltener. Eine {StaticResource}-Markuperweiterungsverwendung kann auch für Zeichenfolgen oder numerische Werte geeignet sein, wenn diese Werte von mehreren Stilen oder Eigenschaften gemeinsam verwendet werden.

Sie müssen sowohl die EigenschaftValue als auch die Eigenschaften für einen Setter angeben. Andernfalls wird eine Ausnahme ausgelöst (entweder eine Analyseausnahme oder ein Laufzeitfehler, je nachdem, ob in Setter 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 Style-Element isttrue. Dies wird auch von der IsSealed-Eigenschaft für eine einzelne gemeldet Setter. Das System legt diese Eigenschaften auf fest true , wenn die Laufzeit Stile auf UI-Elemente anwendet und auf der Benutzeroberfläche anzeigt. Beim Versuch, eine Versiegelung 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 die Setter für die Template-Eigenschaft einer control-abgeleiteten Klasse, die den Großteil des XAML-Markups in einem typischen Styledarstellt. Der Value für ein 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 targetType des Style Elements und TargetType des ControlTemplate-Elements für den Control.Template-Setter immer den gleichen Wert verwenden.

Der Vorlagensetter definiert die grundlegende Vorlagen-UI-Definition für ein Steuerelement instance wo diese Vorlage angewendet wird. Sie 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 der Standardvorlagenstil und die ControlTemplate in Hunderte von XAML-Zeilen enthalten. Weitere Informationen zur Rolle von Style in Steuerelementvorlagenszenarien finden Sie unter XAML-Steuerelementvorlagen.