Setter.Value Eigenschaft

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

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

Hinweise

Wie Sie aus der XAML-Syntax sehen können, gibt es eine Vielzahl von Möglichkeiten, den ValueSetter in XAML anzugeben:

• Als Attribut wird ein Zeichenfolgenwert verwendet. Ein solcher Zeichenfolgenwert kann für einfache Fälle implizit in einen eigenschaftsspezifischen Typ konvertiert werden, z. B. Festlegen numerischer Werte, benannter Werte aus einer Enumeration oder URI (Uniform Resource Identifier).
• Als vollständiges neues Objekt, das in der XAML-Objektelementsyntax deklariert ist, und das Objektelement in einer Eigenschaftselementverwendung geschachtelt wird.
• Als Attribut, das innerhalb der Anführungszeichen eine {StaticResource}-Markuperweiterung verwendet. In der Regel bestimmt der Werttyp der Eigenschaft, welche Syntax geeignet ist. Weitere Informationen zu XAML-Verwendungen finden Sie in der XAML-Übersicht oder im XAML-Syntaxhandbuch. Sie können Attributsyntax für die meisten XAML-UI-Eigenschaften verwenden, und UI-Eigenschaften, die eine Eigenschaftselementnutzung oder einen Ressourcenverweis erfordern, sind weniger häufig. 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 Value auch die Eigenschaften für einen Setter angeben. Andernfalls wird eine Ausnahme ausgelöst (entweder eine Analyseausnahme oder ein Laufzeitfehler, je nachdem, ob dies Setter in XAML erstellt oder im Code geändert wurde).

Wenn Sie mithilfe von Code auf eine Setter-Instanz zugreifen, können Sie den Wert einer Eigenschaft einer Setter Instanz nicht ändern, wenn der Wert der IsSealed-Eigenschaft für ein übergeordnetes Style -Objekt lautet true. Dies wird auch von der IsSealed-Eigenschaft an einer Person Settergemeldet. Das System legt diese Eigenschaften fest, true wenn die Laufzeit Stile auf UI-Elemente anwendet und diese in der Benutzeroberfläche anzeigt. Beim Versuch, ein versiegeltes Setter Objekt zu ändern, wird ein Laufzeitfehler ausgelöst.

Stile und Vorlagen

Sie können einen Setter in einer Formatvorlage verwenden, um Werte auf jede Abhängigkeitseigenschaft anzuwenden. Dies ist jedoch die SetterEigenschaft "Template " einer von Steuerelement abgeleiteten Klasse, die den Großteil des XAML-Markups in einem typischen Beispiel Styledarstellt. Das Value für ein Setter With Property="Template" wird fast immer als Eigenschaftselement angegeben, das ein ControlTemplate-Objektelement enthält.

Wenn eine Formatvorlage zum Definieren einer Steuerelementvorlage verwendet wird, sollte der TargetType des Style Elements und der TargetType des ControlTemplate-Elements für seinen Control.Template-Setter immer denselben Wert verwenden.

Der Vorlagensetter definiert die grundlegende Vorlagen-UI-Definition für eine Steuerelementinstanz, auf die diese Vorlage angewendet wird. Sie enthält auch die visuellen Zustände für ein Steuerelement und andere zustandsbasierte UI-Definitionen wie Standarddesignübergänge. Bei komplexen Steuerelementen wie ListBox kann die Standardvorlagenvorlage "Style" und " ControlTemplate " hunderte VON XAML-Zeilen enthalten. Weitere Informationen zur Rolle von Style Steuerelementvorlagen finden Sie unter XAML-Steuerelementvorlagen.