PropertyMetadata Classe

Définition

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PropertyMetadata

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class PropertyMetadata

Public Class PropertyMetadata

Héritage

Object IInspectable PropertyMetadata

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Exemples

Cet exemple appelle le constructeur PropertyMetadata(Object), qui crée un PropertyMetadata qui signale une valeur par défaut pour un DependencyProperty. PropertyMetadata est ensuite utilisé pour une inscription de propriété jointe lorsque RegisterAttached est appelé.

public abstract class AquariumServices : DependencyObject
{
    public enum Buoyancy {Floats,Sinks,Drifts}

    public static readonly DependencyProperty BuoyancyProperty = DependencyProperty.RegisterAttached(
      "Buoyancy",
      typeof(Buoyancy),
      typeof(AquariumServices),
      new PropertyMetadata(Buoyancy.Floats)
    );
    public static void SetBuoyancy(DependencyObject element, Buoyancy value)
    {
        element.SetValue(BuoyancyProperty, value);
    }
    public static Buoyancy GetBuoyancy(DependencyObject element)
    {
        return (Buoyancy)element.GetValue(BuoyancyProperty);
    }
}

Public Class AquariumServices
    Inherits DependencyObject
    Public Enum Buoyancy
        Floats
        Sinks
        Drifts
    End Enum

    Public Shared ReadOnly BuoyancyProperty As DependencyProperty = _
          DependencyProperty.RegisterAttached(
          "Buoyancy", _
          GetType(Buoyancy), _
          GetType(AquariumServices), _
          New PropertyMetadata(Buoyancy.Floats))


    Public Sub SetBuoyancy(element As DependencyObject, value As Buoyancy)
        element.SetValue(BuoyancyProperty, value)
    End Sub
    Public Function GetBuoyancy(element As DependencyObject) As Buoyancy
        GetBuoyancy = CType(element.GetValue(BuoyancyProperty), Buoyancy)
    End Function
End Class

Remarques

La définition d’un instance PropertyMetadata fait partie du scénario de définition d’une propriété de dépendance personnalisée. Pour obtenir des informations et des exemples, consultez Propriétés de dépendance personnalisées.

Une valeur PropertyMetadata représente deux aspects du comportement des propriétés de dépendance :

• Fournit une valeur par défaut, qui est utilisée comme valeur de la propriété, sauf si le type de propriétaire initialise spécifiquement la valeur, ou si la valeur est définie par le code utilisateur ou d’autres mécanismes.
• Fait référence à un rappel appelé si le système de propriétés de dépendance détecte que la propriété de dépendance a changé. En règle générale, une propriété de dépendance a uniquement besoin d’une valeur PropertyMetadata si l’un de ces comportements ou les deux sont souhaités. Sinon, une valeur null peut être passée pour le paramètre propertyMetadata lorsqu’une propriété de dépendance est inscrite auprès du système de propriétés de dépendance. Pour plus d’informations, consultez DependencyProperty.Register.

Si votre PropertyMetadata inclut une référence de rappel modifiée par une propriété, cette méthode doit être une méthode statique de la classe qui expose l’identificateur DependencyProperty où cette propriété Est appliquée. La procédure d’écriture de cette méthode est décrite dans Propriétés de dépendance personnalisées , ainsi que la rubrique de référence pour le délégué PropertyChangedCallback .

Instanciation d’une valeur PropertyMetadata

Il existe deux méthodes qui peuvent instancier un instance PropertyMetadata : un constructeur et une méthode PropertyMetadata.Create statique. Chacune de ces méthodes a plusieurs signatures. Il est plus courant d’utiliser les constructeurs. Toutefois, vous devez utiliser PropertyMetadata.Create si vous souhaitez que le mécanisme de valeur par défaut de votre propriété de dépendance soit thread-safe. Pour plus d’informations, consultez la section « Métadonnées de propriété pour une propriété de dépendance personnalisée » de la rubrique Propriétés de dépendance personnalisées .

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• Register(String, TypeName, TypeName, PropertyMetadata)
• PropertyChangedCallback
• Propriétés de dépendance personnalisées