PropertyMetadata.DefaultValue Eigenschaft

Definition

Ruft den Standardwert der Abhängigkeitseigenschaft ab oder legt diesen fest.Gets or sets the default value of the dependency property.

public:
 property System::Object ^ DefaultValue { System::Object ^ get(); void set(System::Object ^ value); };
public object DefaultValue { get; set; }
member this.DefaultValue : obj with get, set
Public Property DefaultValue As Object

Eigenschaftswert

Object

Der Standardwert der Eigenschaft.The default value of the property. Der Standardwert für eine- PropertyMetadata Instanz, die mit dem Parameter losen Konstruktor erstellt wird, ist UnsetValue .The default value on a PropertyMetadata instance created with the parameterless constructor will be UnsetValue.

Ausnahmen

Kann nach der Erstellung nicht auf den Wert UnsetValue festgelegt werden.Cannot be set to the value UnsetValue once created.

Kann nach der Anwendung auf eine Abhängigkeitseigenschaftsoperation keine Metadateneigenschaft festlegen.Cannot set a metadata property once it is applied to a dependency property operation.

Hinweise

DefaultValue wird im-Objektmodell als Lese-/Schreibzugriff definiert.DefaultValue is defined in the object model as read-write. Dies DefaultValue kann nach der Initialisierung des Objekts selbst angepasst werden PropertyMetadata .This is so DefaultValue can be adjusted after initialization of the PropertyMetadata object itself. Sobald die Metadaten jedoch als Teil eines Aufrufes von Register , oder verwendet werden AddOwner OverrideMetadata , versiegelte das Eigenschaften System diese Metadateninstanz, und die Eigenschaften werden nun als unveränderlich eingestuft.However, once the metadata is consumed as part of a call to Register, AddOwner, or OverrideMetadata, the property system will seal that metadata instance and the properties are now considered immutable. Wenn Sie versuchen, einmal festzulegen, wird für DefaultValue IsSealed true diese Metadateninstanz eine Ausnahme ausgelöst.Attempting to set DefaultValue once IsSealed is true on this metadata instance will raise an exception.

Obwohl es sich um den Standardwert für den Parameter losen Konstruktor handelt defaultValue , UnsetValue kann ein von nicht mithilfe von DefaultValue oder dem-Konstruktor festgelegt werden.Although it is the default per the parameterless constructor, a defaultValue of UnsetValue cannot be set using either DefaultValue or the constructor. Wenn Sie versuchen, dies zu tun, wird eine Ausnahme ausgelöst.Attempting to do so will raise an exception.

Verwendung von XAML-TextXAML Text Usage

Member dieses Typs werden in der Regel nicht in verwendet XAMLXAML .Members of this type are not typically used in XAMLXAML.

Gilt für: