RequirementAttribute, classe

Article
08/10/2011

Définit les paramètres utilisés par la classe RequirementValidator.

Hiérarchie d'héritage

System.Object
  System.Attribute
    Microsoft.Windows.Design.RequirementAttribute
      Microsoft.Windows.Design.Policies.UsesItemPolicyAttribute
      Microsoft.Windows.Design.RequiresContextItemAttribute
      Microsoft.Windows.Design.RequiresServiceAttribute

Espace de noms : Microsoft.Windows.Design
Assembly : Microsoft.Windows.Design.Extensibility (dans Microsoft.Windows.Design.Extensibility.dll)

Syntaxe

'Déclaration
Public MustInherit Class RequirementAttribute _
    Inherits Attribute

public abstract class RequirementAttribute : Attribute

public ref class RequirementAttribute abstract : public Attribute

[<AbstractClass>]
type RequirementAttribute =  
    class
        inherit Attribute
    end

public abstract class RequirementAttribute extends Attribute

Le type RequirementAttribute expose les membres suivants.

Constructeurs

	Nom	Description
	RequirementAttribute	Initialise une nouvelle instance de la classe RequirementAttribute.

Début

Propriétés

	Nom	Description
	AllRequired	Récupère une valeur qui indique si tous les attributs d'exigences du même type sont requis.
	TypeId	Lors de son implémentation dans une classe dérivée, obtient un identificateur unique pour Attribute. (Hérité de Attribute.)

Début

Méthodes

	Nom	Description
	CreateSubscription	Retourne un objet RequirementSubscription qui peut être utilisé pour être averti lorsque l'exigence contenue dans cet attribut a changé.
	Equals	Infrastructure. Retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
	Finalize	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.)
	GetHashCode	Retourne le code de hachage pour cette instance. (Hérité de Attribute.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	IsDefaultAttribute	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute.)
	Match	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute.)
	MeetsRequirement	Détermine si le EditingContext satisfait aux exigences spécifiées dans cet attribut.
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Implémentations d'interface explicite

	Nom	Description
	_Attribute.GetIDsOfNames	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute.)
	_Attribute.GetTypeInfo	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute.)
	_Attribute.GetTypeInfoCount	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute.)
	_Attribute.Invoke	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute.)

Début

Notes

Dérive de la classe abstraite RequirementAttribute pour spécifier des exigences pour vos fournisseurs et connecteurs de fonctionnalités.

RequirementValidator inspecte des types pour les attributs RequirementAttribute. Pour chaque RequirementAttribute qu'il trouve, il appelle la méthode abstraite MeetsRequirement, en passant une instance de la classe EditingContext. Les classes telles que RequiresServiceAttribute dérivent de RequirementAttribute et vérifient la présence d'un critère spécifié dans le contexte.

Ce système permet au concepteur d'activer uniquement le code qui peut s'exécuter avec succès dans le contexte d'édition.

Définissez vos spécifications personnalisées en dérivant de RequirementAttribute et en implémentant la méthode abstraite MeetsRequirement.

Exemples

L'exemple de code suivant indique comment joindre une stratégie de substitution personnalisée à un fournisseur de fonctionnalités en utilisant UsesItemPolicyAttribute qui dérive de RequirementAttribute. Pour obtenir l'intégralité du code, consultez Comment : créer une stratégie de substitution.

' The DockPanelAdornerProvider class implements an adorner
' that you can use to set the Margin property by using a 
' drag operation. The DockPanelPolicy class enables a 
' container policy for offering additional tasks and 
' adorners on the panel's children.
<UsesItemPolicy(GetType(DockPanelPolicy))>  _
Class DockPanelAdornerProvider
    Inherits AdornerProvider

    Public Sub New() 
        ' The adorner is a Rectangle element.
        Dim r As New Rectangle()
        r.Width = 23.0
        r.Height = 23.0
        r.Fill = AdornerColors.GlyphFillBrush

        ' Set the rectangle's placement in the adorner panel.
        AdornerPanel.SetAdornerHorizontalAlignment(r, AdornerHorizontalAlignment.OutsideLeft)
        AdornerPanel.SetAdornerVerticalAlignment(r, AdornerVerticalAlignment.OutsideTop)

        Dim p As New AdornerPanel()
        p.Children.Add(r)

        AdornerPanel.SetTask(r, New DockPanelMarginTask())

        Adorners.Add(p)
    End Sub
End Class

// The DockPanelAdornerProvider class implements an adorner
// that you can use to set the Margin property by using a 
// drag operation. The DockPanelPolicy class enables a 
// container policy for offering additional tasks and 
// adorners on the panel's children.
[UsesItemPolicy(typeof(DockPanelPolicy))]
class DockPanelAdornerProvider : AdornerProvider
{
    public DockPanelAdornerProvider() 
    {
        // The adorner is a Rectangle element.
        Rectangle r = new Rectangle();
        r.Width = 23.0;
        r.Height = 23.0;
        r.Fill = AdornerColors.GlyphFillBrush;

        // Set the rectangle's placement in the adorner panel.
        AdornerPanel.SetAdornerHorizontalAlignment(r, AdornerHorizontalAlignment.OutsideLeft);
        AdornerPanel.SetAdornerVerticalAlignment(r, AdornerVerticalAlignment.OutsideTop);

        AdornerPanel p = new AdornerPanel();
        p.Children.Add(r);

        AdornerPanel.SetTask(r, new DockPanelMarginTask());

        Adorners.Add(p);
    }
}

Sécurité des threads

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.