AttributeTableBuilder, classe

Crée une table d'attributs qui définit les métadonnées au moment du design.

Hiérarchie d'héritage

System.Object
  Microsoft.Windows.Design.Metadata.AttributeTableBuilder

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

Syntaxe

'Déclaration
Public Class AttributeTableBuilder

public class AttributeTableBuilder

public ref class AttributeTableBuilder

type AttributeTableBuilder =  class end

public class AttributeTableBuilder

Le type AttributeTableBuilder expose les membres suivants.

Constructeurs

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

Début

Méthodes

	Nom	Description
	AddCallback	Ajoute un rappel qui est appelé lorsque les métadonnées pour le type spécifié sont nécessaires.
	AddCustomAttributes(Assembly, array<Attribute[])	Ajoute le contenu du tableau d'attributs fournis au générateur de tables.
	AddCustomAttributes(Type, array<Attribute[])	Ajoute le contenu des attributs fournis au générateur de tables.
	AddCustomAttributes(Type, String, array<Attribute[])	Ajoute des attributs au membre qui porte le nom spécifié.
	AddTable	Ajoute le contenu de la table d'attributs fournie au générateur de tables.
	CreateTable	Crée une table d'attributs qui contient toutes les définitions d'attribut fournies par le biais d'appels AddCustomAttributes.
	Equals	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	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	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	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.)
	ValidateTable	Cette méthode est utilisée pour vérifier que la table d'attributs générée contient des informations d'attribut valides.

Début

Notes

Pour créer une table d'attributs, vous commencez par créer une instance de la classe AttributeTableBuilder. Vous ajoutez les métadonnées au générateur de table d'attributs en appelant les surcharges AddCustomAttributes. Lorsque vous avez terminé d'ajouter les métadonnées, vous produisez une table d'attributs à partir du générateur de table d'attributs en appelant la méthode CreateTable. Les méthodes du générateur de table d'attributs prenant en charge les délégués de rappel, la création de la table d'attributs peut être différée autant que cela est nécessaire.

Utilisez la classe AttributeCallbackBuilder au lieu de la classe AttributeTableBuilder si vous ajoutez de nombreux attributs. Cette approche diffère la création d'attributs jusqu'à ce que le concepteur demande les métadonnées pour le type de cible.

Exemples

L'exemple de code suivant indique comment créer et remplir une table d'attributs à l'aide de la classe AttributeTableBuilder. Pour plus d'informations, consultez Procédure pas à pas : création d'un ornement au moment du design.

Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Reflection
Imports System.Text
Imports System.Windows.Media
Imports System.Windows.Controls
Imports System.Windows

Imports Microsoft.Windows.Design.Features
Imports Microsoft.Windows.Design.Metadata

' The ProvideMetadata assembly-level attribute indicates to designers
' that this assembly contains a class that provides an attribute table. 
<Assembly: ProvideMetadata(GetType(CustomControlLibrary.VisualStudio.Design.Metadata))> 

' Container for any general design-time metadata to initialize.
' Designers look for a type in the design-time assembly that 
' implements IRegisterMetadata. If found, designers instantiate 
' this class and call its Register() method automatically.
Friend Class Metadata
    Implements IProvideAttributeTable

    ' Accessed by the designer to register any design-time metadata.
    Public ReadOnly Property AttributeTable() As AttributeTable _
        Implements IProvideAttributeTable.AttributeTable
        Get
            Dim builder As New AttributeTableBuilder()

            builder.AddCustomAttributes( _
                GetType(Button), _
                New DefaultPropertyAttribute("Content"))

            ' Apply the ReadOnlyAttribute to the Background property 
            ' of the Button class.
            builder.AddCustomAttributes( _
                GetType(Button), _
                "Background", _
                New ReadOnlyAttribute(True))

            Dim attributes As AttributeTable = builder.CreateTable()

            Return attributes
        End Get
    End Property

End Class

using System;
using System.Collections;
using System.Collections.Generic;
using System.ComponentModel;
using System.Reflection;
using System.Text;
using System.Windows.Media;
using System.Windows.Controls;
using System.Windows;

using Microsoft.Windows.Design.Features;
using Microsoft.Windows.Design.Metadata;

// The ProvideMetadata assembly-level attribute indicates to designers
// that this assembly contains a class that provides an attribute table. 
[assembly: ProvideMetadata(typeof(CustomControlLibrary.VisualStudio.Design.Metadata))]
namespace CustomControlLibrary.VisualStudio.Design
{
    // Container for any general design-time metadata to initialize.
    // Designers look for a type in the design-time assembly that 
    // implements IProvideAttributeTable. If found, designers instantiate 
    // this class and access its AttributeTable property automatically.
    internal class Metadata : IProvideAttributeTable
    {
        // Accessed by the designer to register any design-time metadata.
        public AttributeTable AttributeTable
        {
            get 
            {
                AttributeTableBuilder builder = new AttributeTableBuilder();

                builder.AddCustomAttributes(
                    typeof(Button),
                    new DefaultPropertyAttribute("Content"));

                // Apply the ReadOnlyAttribute to the Background property 
                // of the Button class.
                builder.AddCustomAttributes(
                    typeof(Button),
                    "Background",
                    new ReadOnlyAttribute(true));

                AttributeTable attributes = builder.CreateTable();

                return attributes;
            }
        }
    }
}

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.

Voir aussi

Référence

Microsoft.Windows.Design.Metadata, espace de noms

AttributeTable

AttributeCallbackBuilder