AttributeCallbackBuilder, classe

Article
08/23/2008

Mise à jour : novembre 2007

Une instance de cette classe est passée aux délégués de rappel pour remplir progressivement les attributs d'un type.

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

Syntaxe

Public NotInheritable Class AttributeCallbackBuilder

Dim instance As AttributeCallbackBuilder

public sealed class AttributeCallbackBuilder

public ref class AttributeCallbackBuilder sealed

public final class AttributeCallbackBuilder

Notes

Utilisez AttributeCallbackBuilder pour remplir un AttributeTable à la demande. C'est particulièrement important pour les tables d'attributs qui contiennent de nombreux attributs. Si vous ne spécifiez que quelques attributs pour un type, utilisez AttributeTableBuilder par lui-même.

Avec le format de délégué, aucun attribut n'est construit tant que le concepteur n'a pas demandé de métadonnées pour le type de cible. Le AttributeTableBuilder transfère cette information de rappel dans le AttributeTable et la conserve. Par conséquent, ces délégués de rappel sont appelés uniquement à la demande. Une fois appelés, leurs résultats sont mis en cache par le AttributeTable.

Activez la création d'attribut à la demande à l'aide de la méthode AddCallback.

Exemples

L'exemple de code suivant indique comment créer et remplir une table d'attributs à l'aide de la classe AttributeCallbackBuilder.

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

using Microsoft.Windows.Design.Features;
using Microsoft.Windows.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 IRegisterMetadata. If found, designers instantiate 
    // this class and call its Register() method automatically.
    internal class Metadata : IRegisterMetadata
    {
        // Called by the designer to register any design-time metadata.
        public void Register()
        {
            AttributeTableBuilder builder = new AttributeTableBuilder();

            // Build the attribute table by using the AttributeCallbackBuilder 
            // class. The attribute table is not populated until the designer
            // needs it, which is more efficient for large attribute tables.
            builder.AddCallback(
                typeof(Button), 
                delegate(AttributeCallbackBuilder callbackBuilder)
            {
                callbackBuilder.AddCustomAttributes(
                    new DefaultPropertyAttribute("Content"));

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

                PropertyDescriptorCollection properties =
                    TypeDescriptor.GetProperties(typeof(Button));
                PropertyDescriptor pd = properties["Foreground"];
                callbackBuilder.AddCustomAttributes(
                    pd,
                    new ReadOnlyAttribute(true));

                callbackBuilder.AddCustomAttributes(
                   Button.WidthProperty,
                   new TypeConverterAttribute(typeof(LengthConverter)),
                   new DescriptionAttribute("This is the width"));

                MemberInfo[] members = typeof(Button).GetMember("Height");
                callbackBuilder.AddCustomAttributes(
                    members[0],
                    new ReadOnlyAttribute(true));
            });

            MetadataStore.AddAttributeTable(builder.CreateTable());
        }
    }
}

Hiérarchie d'héritage

System.Object
Microsoft.Windows.Design.Metadata.AttributeCallbackBuilder

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.