AttributeTableBuilder (Clase)

Crea una tabla de atributos que en la que se definen los metadatos en tiempo de diseño.

Jerarquía de herencia

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

Espacio de nombres:  Microsoft.Windows.Design.Metadata
Ensamblado:  Microsoft.Windows.Design.Extensibility (en Microsoft.Windows.Design.Extensibility.dll)

Sintaxis

'Declaración
Public Class AttributeTableBuilder

public class AttributeTableBuilder

public ref class AttributeTableBuilder

type AttributeTableBuilder =  class end

public class AttributeTableBuilder

El tipo AttributeTableBuilder expone los siguientes miembros.

Constructores

	Nombre	Descripción
	AttributeTableBuilder	Inicializa una nueva instancia de la clase AttributeTableBuilder.

Arriba

Métodos

	Nombre	Descripción
	AddCallback	Agrega una devolución de llamada que se invoca cuando se necesitan los metadatos para el tipo especificado.
	AddCustomAttributes(Assembly, array<Attribute[])	Agrega el contenido de la matriz de atributos proporcionada al generador de la tabla.
	AddCustomAttributes(Type, array<Attribute[])	Agrega el contenido de los atributos proporcionados al generador de la tabla.
	AddCustomAttributes(Type, String, array<Attribute[])	Agrega los atributos al miembro con el nombre especificado.
	AddTable	Agrega el contenido de la tabla de atributos proporcionada al generador de la tabla.
	CreateTable	Crea una tabla de atributos que contiene todas las definiciones de atributos proporcionadas mediante llamadas AddCustomAttributes.
	Equals	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
	ValidateTable	Este método se utiliza para comprobar que la tabla de atributos que se está generando contiene información de atributos válida.

Arriba

Comentarios

Para crear una tabla de atributos, empiece creando una instancia de la clase AttributeTableBuilder. Los metadatos se agregan al generador de la tabla de atributos llamando a las sobrecargas AddCustomAttributes. Cuando termine de agregar metadatos, genere una tabla de atributos desde el generador de la tabla de atributos llamando al método CreateTable. Los métodos del generador de la tabla de atributos admiten delegados de devolución de llamada, por tanto, la creación de la tabla de atributos se puede aplazar hasta que sea necesario.

Use la clase AttributeCallbackBuilder en lugar de la clase AttributeTableBuilder si está agregando muchos atributos. Este procedimiento aplaza la creación de atributos hasta que el diseñador solicite los metadatos para el tipo de destino.

Ejemplos

En el siguiente ejemplo de código se muestra cómo usar la clase AttributeTableBuilder para crear y rellenar una tabla de atributos. Para obtener más información, vea Tutorial: Crear un adorno en tiempo de diseño.

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;
            }
        }
    }
}

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

Microsoft.Windows.Design.Metadata (Espacio de nombres)

AttributeTable

AttributeCallbackBuilder