AttributeTable-Klasse

Eine Tabelle mit Metadatenattributen zum Definieren der Darstellung und des Verhaltens zur Entwurfszeit.

Vererbungshierarchie

System.Object
  Microsoft.Windows.Design.Metadata.AttributeTable

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

Syntax

'Declaration
Public NotInheritable Class AttributeTable

public sealed class AttributeTable

public ref class AttributeTable sealed

[<Sealed>]
type AttributeTable =  class end

public final class AttributeTable

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

Eigenschaften

	Name	Beschreibung
	AttributedTypes	Ruft eine Enumeration aller Typen ab, die über Attributüberschreibungen verfügen, beispielsweise für eine Eigenschaft oder den Typ selbst.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	ContainsAttributes	Gibt einen Wert zurück, der angibt, ob diese Tabelle Metadaten für den angegebenen Typ enthält.
	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.)
	GetCustomAttributes(Assembly)	Gibt eine Enumeration aller Attribute zurück, die für die angegebene Assembly bereitgestellt werden.
	GetCustomAttributes(Type)	Gibt eine Enumeration aller Attribute zurück, die für den angegebenen Typ bereitgestellt werden.
	GetCustomAttributes(Type, String)	Gibt eine Enumeration aller Attribute zurück, die für den angegebenen Typ und Membernamen bereitgestellt werden.
	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.)

Zum Seitenanfang

Hinweise

Verwenden Sie die AttributeTable-Klasse, um Metadatenattribute zur Entwurfszeit Windows Presentation Foundation (WPF)-Typen zuzuordnen.

Um eine Attributtabelle zu erstellen, rufen Sie die CreateTable-Methode der AttributeTableBuilder-Klasse auf. Weitere Informationen finden Sie unter Bereitstellen von Entwurfszeitmetadaten.

Eine Attributtabelle ist im Wesentlichen ein schreibgeschütztes Wörterbuch, ihre Schlüssel und Werte werden jedoch getrennt berechnet. Es ist effizient, eine Attributtabelle abzufragen, wenn sie Attribute für einen bestimmten Typ enthält. Der tatsächliche Satz von Attributen wird bei Bedarf erstellt.

Beispiele

Das folgende Codebeispiel zeigt das Erstellen und das Füllen einer Attributtabelle. 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
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 IProvideAttributeTable. If found, designers instantiate
' this class and access its AttributeTable property 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()

            ' 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()

            Dim hasCustomAttributes As Boolean = attributes.ContainsAttributes(GetType(Button))

            Dim types As IEnumerable(Of Type) = attributes.AttributedTypes

            ' The following code shows how to retrieve custom attributes
            ' using the GetCustomAttributes method overloads.
            Dim attrs0 As IEnumerable = attributes.GetCustomAttributes(GetType(Button))

            Dim attrs1 As IEnumerable = attributes.GetCustomAttributes(GetType(Button), "Background")

            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();

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

                AttributeTable attributes = builder.CreateTable();

                bool hasCustomAttributes = attributes.ContainsAttributes(typeof(Button));

                IEnumerable<Type> types = attributes.AttributedTypes;

                // The following code shows how to retrieve custom attributes
                // using the GetCustomAttributes method overloads.
                IEnumerable attrs0 = attributes.GetCustomAttributes(typeof(Button));

                IEnumerable attrs1 = attributes.GetCustomAttributes(
                    typeof(Button),
                    "Background");

                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

AttributeTableBuilder

Weitere Ressourcen

Bereitstellen von Entwurfszeitmetadaten