Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

DependencyObject, classe

Représente un objet qui participe au système de propriétés de dépendance.

Espace de noms :  System.Windows
Assembly :  WindowsBase (dans WindowsBase.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[NameScopePropertyAttribute("NameScope", typeof(NameScope))]
public class DependencyObject : DispatcherObject

Le type DependencyObject expose les membres suivants.

  NomDescription
Méthode publiqueDependencyObjectInitialise une nouvelle instance de la classe DependencyObject.
Début

  NomDescription
Propriété publiqueDependencyObjectTypeObtient le DependencyObjectType qui encapsule le type CLR de cette instance. 
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueIsSealedRécupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).
Début

  NomDescription
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publiqueClearValue(DependencyProperty)Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty.
Méthode publiqueClearValue(DependencyPropertyKey)Efface la valeur de proximité d'une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey.
Méthode publiqueCoerceValueForce la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme elle existe sur le DependencyObject appelant.
Méthode publiqueEqualsDétermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Substitue Object.Equals(Object).)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeObtient un code de hachage pour ce DependencyObject. (Substitue Object.GetHashCode().)
Méthode publiqueGetLocalValueEnumeratorCrée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetValueRetourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject.
Méthode publiqueInvalidatePropertyRéévalue la valeur effective pour la propriété de dépendance spécifiée
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégéeOnPropertyChangedAppelé à chaque fois que la valeur effective d'une propriété de dépendance sur ce DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a été modifiée est signalée dans les données d'événement.
Méthode publiqueReadLocalValueRetourne la valeur de proximité d'une propriété de dépendance, si elle existe.
Méthode publiqueSetCurrentValueDéfinit la valeur d'une propriété de dépendance sans modifier sa source de valeur.
Méthode publiqueSetValue(DependencyProperty, Object)Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.
Méthode publiqueSetValue(DependencyPropertyKey, Object)Définit la valeur de proximité d'une propriété de dépendance en lecture seule, spécifiée par l'identificateur DependencyPropertyKey de la propriété de dépendance.
Méthode protégéeShouldSerializePropertyRetourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour la propriété de dépendance fournie.
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Début

La classe DependencyObject active des services de système de propriétés Windows Presentation Foundation (WPF) sur ses nombreuses classes dérivées.

La fonction principale du système de propriétés est de calculer les valeurs de propriétés, et de fournir la notification de système à propos des valeurs qui ont changé. Une autre classe clé qui participe au système de propriétés est DependencyProperty.DependencyProperty active l'inscription de propriétés de dépendance dans le système de propriétés, et fournit l'identification et les informations concernant chaque propriété de dépendance, alors que DependencyObject comme classe de base permet aux objets d'utiliser les propriétés de dépendance.

Les services DependencyObject et caractéristiques incluent les éléments suivants :

  • Prise en charge de l'hébergement de propriété de dépendance. Vous enregistrez une propriété de dépendance en appelant la méthode Register, et en stockant la valeur de retour de la méthode comme un champ statique public dans votre classe.

  • Prise en charge de l'hébergement de propriété attachée. Vous enregistrez une propriété attachée en appelant la méthode RegisterAttached, et en stockant la valeur de retour de la méthode comme un champ statique public en lecture seule dans votre classe. (Il existe également des spécifications de membre supplémentaires ; notez que cela représente une implémentation spécifique WPF pour les propriétés attachées. Pour plus d'informations, consultez Vue d'ensemble des propriétés jointes. Votre propriété attachée peut ensuite être définie sur toute classe qui dérive de DependencyObject.

  • Obtenez, définissez, et supprimez des méthodes utilitaires pour les valeurs de toutes propriétés de dépendance qui existent sur le DependencyObject.

  • Métadonnées, prise en charge forcée de valeur, notification de modification de propriété, et rappels de substitution pour les propriétés de dépendance ou les propriétés attachées. La classe DependencyObject facilite également les métadonnées de propriété par propriétaire pour une propriété de dépendance.

  • Une classe de base courante pour les classes dérivées de ContentElement, Freezable ou Visual. (UIElement, une autre classe d'élément de base, a une hiérarchie de classes qui inclut Visual.)

L'exemple suivant dérive de DependencyObject pour créer une classe abstraite. La classe enregistre ensuite une propriété attachée et inclut des membres de support pour cette propriété attachée.


public abstract class AquariumObject3 : DependencyObject
{
    public enum Bouyancy
    {
        Floats,
        Sinks,
        Drifts
    }
    public static readonly DependencyProperty BouyancyProperty = DependencyProperty.RegisterAttached(
      "Bouyancy",
      typeof(Bouyancy),
      typeof(AquariumObject3),
      new FrameworkPropertyMetadata(Bouyancy.Floats, FrameworkPropertyMetadataOptions.AffectsArrange),
      new ValidateValueCallback(ValidateBouyancy)
    );
    public static void SetBouyancy(UIElement element, Bouyancy value)
    {
        element.SetValue(BouyancyProperty, value);
    }
    public static Bouyancy GetBouyancy(UIElement element)
    {
        return (Bouyancy)element.GetValue(BouyancyProperty);
    }
    private static bool ValidateBouyancy(object value)
    {
        Bouyancy bTest = (Bouyancy) value;
        return (bTest == Bouyancy.Floats || bTest == Bouyancy.Drifts || bTest==Bouyancy.Sinks);
    }
    public static readonly DependencyProperty IsDirtyProperty = DependencyProperty.Register(
      "IsDirty",
      typeof(Boolean),
      typeof(AquariumObject3)
    );
}


.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

Afficher:
© 2014 Microsoft