AttributeTableBuilder-Klasse

Erstellt eine Attributtabelle, in der Entwurfszeitmetadaten definiert werden.

Vererbungshierarchie

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

Namespace:  Microsoft.Windows.Design.Metadata
Assembly:  Microsoft.Windows.Design.Extensibility (in Microsoft.Windows.Design.Extensibility.dll)

Syntax

'Declaration
Public Class AttributeTableBuilder

public class AttributeTableBuilder

public ref class AttributeTableBuilder

type AttributeTableBuilder =  class end

public class AttributeTableBuilder

Der AttributeTableBuilder-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	AttributeTableBuilder	Initialisiert eine neue Instanz der AttributeTableBuilder-Klasse.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddCallback	Fügt einen Rückruf hinzu, der aufgerufen wird, wenn Metadaten für den angegebenen Typ benötigt werden.
	AddCustomAttributes(Assembly, array<Attribute[])	Fügt den Inhalt des bereitgestellten Attributarrays dem Tabellen-Generator hinzu.
	AddCustomAttributes(Type, array<Attribute[])	Fügt den Inhalt der bereitgestellten Attribute dem Tabellen-Generator hinzu.
	AddCustomAttributes(Type, String, array<Attribute[])	Fügt Attribute zu dem Member mit dem angegebenen Namen hinzu.
	AddTable	Fügt den Inhalt der bereitgestellten Attributtabelle dem Tabellen-Generator hinzu.
	CreateTable	Erstellt eine Attributtabelle mit allen Attributdefinitionen, die durch AddCustomAttributes-Aufrufe bereitgestellt werden.
	Equals	Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
	ValidateTable	Mit dieser Methode wird überprüft, ob die zu erstellende Attributtabelle gültige Attributinformationen enthält.

Zum Seitenanfang

Hinweise

Zur Erstellung einer Attributtabelle erstellen Sie zunächst eine Instanz der AttributeTableBuilder-Klasse. Fügen Sie dem Attributtabellen-Generator Metadaten hinzu, indem Sie die AddCustomAttributes-Überladungen aufrufen. Nachdem Sie die Metadaten hinzugefügt haben, erstellen Sie aus dem Attributtabellen-Generator eine Attributtabelle, indem Sie die CreateTable-Methode aufrufen. Die Methoden des Attributtabellen-Generators unterstützen Rückrufdelegaten. Somit kann die Erstellung der Attributtabelle bis zum gewünschten Zeitpunkt hinausgezögert werden.

Verwenden Sie die AttributeCallbackBuilder-Klasse anstelle der AttributeTableBuilder-Klasse, wenn Sie viele Attribute hinzufügen. Bei diesem Ansatz wird die Erstellung von Attributen verzögert, bis vom Designer Metadaten für den Zieltyp angefordert werden.

Beispiele

Im folgenden Codebeispiel ist dargestellt, wie eine Attributtabelle mithilfe der AttributeTableBuilder-Klasse erstellt und aufgefüllt wird. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Entwurfszeitadorners.

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.Windows.Design.Metadata-Namespace

AttributeTable

AttributeCallbackBuilder