Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

PropertyDescriptor-Klasse

Stellt eine Abstraktion einer Eigenschaft für eine Klasse bereit.

Namespace:  System.ComponentModel
Assembly:  System (in System.dll)
[ComVisibleAttribute(true)]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public abstract class PropertyDescriptor : MemberDescriptor

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

  NameBeschreibung
Geschützte MethodeUnterstützt von XNA FrameworkPropertyDescriptor(MemberDescriptor)Initialisiert eine neue Instanz der PropertyDescriptor-Klasse mit dem Namen und den Attributen in der angegebenen MemberDescriptor-Klasse.
Geschützte MethodeUnterstützt von XNA FrameworkPropertyDescriptor(MemberDescriptor, Attribute[])Initialisiert eine neue Instanz der PropertyDescriptor-Klasse mit dem Namen in der angegebenen MemberDescriptor-Klasse und den Attributen in der MemberDescriptor-Klasse sowie im Attribute-Array.
Geschützte MethodeUnterstützt von XNA FrameworkPropertyDescriptor(String, Attribute[])Initialisiert eine neue Instanz der PropertyDescriptor-Klasse mit dem angegebenen Namen und den angegebenen Attributen.
Zum Seitenanfang
  NameBeschreibung
Geschützte EigenschaftUnterstützt von XNA FrameworkAttributeArrayRuft ein Array von Attributen ab oder legt dieses fest. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftAttributesRuft die Auflistung von Attributen für diesen Member ab. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftCategoryRuft den Namen der Kategorie ab, zu der der Member gehört. Dieser ist in der CategoryAttribute-Klasse angegeben. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkComponentTypeRuft beim Überschreiben in einer abgeleiteten Klasse den Typ der Komponente ab, an die diese Eigenschaft gebunden ist.
Öffentliche EigenschaftConverterRuft den Typkonverter für diese Eigenschaft ab.
Öffentliche EigenschaftDescriptionRuft die Beschreibung des Members ab, die in der DescriptionAttribute-Klasse angegeben ist. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftDesignTimeOnlyRuft ab, ob dieser Member nur zur Entwurfszeit festgelegt werden darf. Dies ist in der DesignOnlyAttribute-Klasse angegeben. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkDisplayNameRuft den Namen ab, der in einem Fenster, z. B. im Eigenschaftenfenster, angezeigt werden kann. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftIsBrowsableRuft einen Wert ab, der angibt, ob der Member durchsucht werden kann. Dies ist in der BrowsableAttribute-Klasse angegeben. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftIsLocalizableRuft einen Wert ab, der angibt, ob diese Eigenschaft gemäß den Angaben in LocalizableAttribute lokalisiert werden soll.
Öffentliche EigenschaftUnterstützt von XNA FrameworkIsReadOnlyRuft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob diese Eigenschaft schreibgeschützt ist.
Öffentliche EigenschaftUnterstützt von XNA FrameworkNameRuft den Namen des Members ab. (Von MemberDescriptor geerbt.)
Geschützte EigenschaftUnterstützt von XNA FrameworkNameHashCodeRuft den Hashcode für den Namen des Members ab, der in GetHashCode angegeben ist. (Von MemberDescriptor geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkPropertyTypeRuft beim Überschreiben in einer abgeleiteten Klasse den Typ der Eigenschaft ab.
Öffentliche EigenschaftSerializationVisibilityRuft einen Wert ab, der angibt, ob diese Eigenschaft gemäß den Angaben in DesignerSerializationVisibilityAttribute serialisiert werden soll.
Öffentliche EigenschaftUnterstützt von XNA FrameworkSupportsChangeEventsRuft einen Wert ab, der angibt, ob Wertänderungsbenachrichtigungen für diese Eigenschaft von außerhalb des Eigenschaftendeskriptors stammen dürfen.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkAddValueChangedErmöglicht es, andere Objekte zu benachrichtigen, wenn sich diese Eigenschaft ändert.
Öffentliche MethodeUnterstützt von XNA FrameworkCanResetValueGibt beim Überschreiben in einer abgeleiteten Klasse zurück, ob beim Zurücksetzen eines Objekts dessen Wert geändert wird.
Geschützte MethodeUnterstützt von XNA FrameworkCreateAttributeCollectionErstellt eine Auflistung von Attributen, wobei das Array von Attributen verwendet wird, das an den Konstruktor übergeben wurde. (Von MemberDescriptor geerbt.)
Geschützte MethodeCreateInstanceErstellt eine Instanz des angegebenen Typs.
Öffentliche MethodeUnterstützt von XNA FrameworkEqualsVergleicht dieses Objekt mit einem anderen auf Äquivalenz. (Überschreibt MemberDescriptor.Equals(Object).)

In XNA Framework 3.0 wird dieser Member von Object geerbt..Equals(Object).
Geschützte MethodeUnterstützt von XNA FrameworkFillAttributesFügt der angegebenen Liste der Attribute in der übergeordneten Klasse die Attribute der PropertyDescriptor-Klasse hinzu. (Überschreibt MemberDescriptor.FillAttributes(IList).)

In XNA Framework 3.0 wird dieser Member von MemberDescriptor geerbt..FillAttributes(IList).
Geschützte MethodeUnterstützt von XNA FrameworkFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetChildProperties()Gibt die als Standard festgelegte PropertyDescriptorCollection-Klasse zurück.
Öffentliche MethodeGetChildProperties(Attribute[])Gibt eine PropertyDescriptorCollection-Klasse unter Verwendung eines angegebenen Arrays von Attributen als Filter zurück.
Öffentliche MethodeGetChildProperties(Object)Gibt eine PropertyDescriptorCollection-Klasse für ein angegebenes Objekt zurück.
Öffentliche MethodeGetChildProperties(Object, Attribute[])Gibt eine PropertyDescriptorCollection-Klasse für ein angegebenes Objekt zurück, wobei ein angegebenes Array von Attributen als Filter verwendet wird.
Öffentliche MethodeGetEditorRuft einen Editor des angegebenen Typs ab.
Öffentliche MethodeUnterstützt von XNA FrameworkGetHashCodeGibt den Hashcode für dieses Objekt zurück. (Überschreibt MemberDescriptor.GetHashCode().)

In XNA Framework wird dieser Member von GetHashCode() überschrieben.
Geschützte MethodeGetInvocationTargetDiese Methode gibt das Objekt zurück, das beim Aufrufen der Member verwendet werden sollte. (Überschreibt MemberDescriptor.GetInvocationTarget(Type, Object).)
Öffentliche MethodeUnterstützt von XNA FrameworkGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeGetTypeFromNameGibt einen Typ unter Verwendung seines Namens zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkGetValueRuft beim Überschreiben in einer abgeleiteten Klasse den aktuellen Wert der Eigenschaft einer Komponente ab.
Geschützte MethodeUnterstützt von XNA FrameworkGetValueChangedHandlerRuft den aktuellen Satz von ValueChanged-Ereignishandlern für eine bestimmte Komponente ab.
Geschützte MethodeUnterstützt von XNA FrameworkMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkOnValueChangedLöst das ValueChanged-Ereignis aus, das Sie implementiert haben.
Öffentliche MethodeUnterstützt von XNA FrameworkRemoveValueChangedErmöglicht es, andere Objekte zu benachrichtigen, wenn sich diese Eigenschaft ändert.
Öffentliche MethodeUnterstützt von XNA FrameworkResetValueSetzt beim Überschreiben in einer abgeleiteten Klasse den Wert dieser Komponenteneigenschaft auf den Standardwert zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkSetValueLegt beim Überschreiben in einer abgeleiteten Klasse den Wert der Komponente auf einen anderen Wert fest.
Öffentliche MethodeUnterstützt von XNA FrameworkShouldSerializeValueBestimmt beim Überschreiben in einer abgeleiteten Klasse einen Wert, der angibt, ob der Wert dieser Eigenschaft beibehalten werden muss.
Öffentliche MethodeUnterstützt von XNA FrameworkToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

Die Beschreibung einer Eigenschaft besteht aus einem Namen, den Attributen, der Komponentenklasse, der die Eigenschaft zugeordnet ist, und dem Eigenschaftentyp.

PropertyDescriptor stellt die folgenden Eigenschaften und Methoden bereit:

Die PropertyDescriptor-Klasse stellt außerdem die folgenden abstract-Eigenschaften und -Methoden bereit:

  • ComponentType enthält den Typ der Komponente, an die diese Eigenschaft gebunden ist.

  • IsReadOnly gibt an, ob diese Eigenschaft schreibgeschützt ist.

  • PropertyType ruft den Typ der Eigenschaft ab.

  • CanResetValue gibt an, ob durch das Zurücksetzen der Komponente ihr Wert geändert wird.

  • GetValue gibt den aktuellen Wert der Eigenschaft einer Komponente an.

  • ResetValue setzt den Wert der Komponente für diese Eigenschaft zurück.

  • SetValue legt den Wert der Komponente auf einen anderen Wert fest.

  • ShouldSerializeValue gibt an, ob der Wert dieser Eigenschaft beibehalten werden muss.

In der Regel werden die abstract-Member über Reflektion implementiert. Weitere Informationen über Reflektion finden Sie unter den Themen zu Reflektion in .NET Framework.

HinweisHinweis

Das auf diesen Typ oder Member angewendete HostProtectionAttribute-Attribut besitzt den folgenden Resources-Eigenschaftswert: SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Das folgende Codebeispiel basiert auf dem Beispiel in der PropertyDescriptorCollection-Klasse. Es gibt die Informationen (Kategorie, Beschreibung, Anzeigename) des Textes einer Schaltfläche in einem Textfeld aus. Dabei wird vorausgesetzt, dass button1 und textbox1 in einem Formular instanziiert wurden.


// Creates a new collection and assign it the properties for button1.
PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);

// Sets an PropertyDescriptor to the specific property.
System.ComponentModel.PropertyDescriptor myProperty = properties.Find("Text", false);

// Prints the property and the property description.
textBox1.Text = myProperty.DisplayName+ '\n' ;
textBox1.Text += myProperty.Description + '\n';
textBox1.Text += myProperty.Category + '\n';


Im folgenden Codebeispiel wird veranschaulicht, wie ein benutzerdefinierter Eigenschaftendeskriptor implementiert wird, der einen schreibgeschützten Wrapper für eine Eigenschaft bereitstellt. Der SerializeReadOnlyPropertyDescriptor wird in einem benutzerdefinierten Designer verwendet, um einen schreibgeschützten Eigenschaftendeskriptor für die Size-Eigenschaft des Steuerelements bereitzustellen.


using System;
using System.Collections;
using System.ComponentModel;
using System.Text;

namespace ReadOnlyPropertyDescriptorTest
{
    // The SerializeReadOnlyPropertyDescriptor shows how to implement a 
    // custom property descriptor. It provides a read-only wrapper 
    // around the specified PropertyDescriptor. 
    internal sealed class SerializeReadOnlyPropertyDescriptor : PropertyDescriptor
    {
        private PropertyDescriptor _pd = null;

        public SerializeReadOnlyPropertyDescriptor(PropertyDescriptor pd)
            : base(pd)
        {
            this._pd = pd;
        }

        public override AttributeCollection Attributes
        {
            get
            {
                return( AppendAttributeCollection(
                    this._pd.Attributes, 
                    ReadOnlyAttribute.Yes) );
            }
        }

        protected override void FillAttributes(IList attributeList)
        {
            attributeList.Add(ReadOnlyAttribute.Yes);
        }

        public override Type ComponentType
        {
            get
            {
                return this._pd.ComponentType;
            }
        }


        // The type converter for this property.
        // A translator can overwrite with its own converter.
        public override TypeConverter Converter
        {
            get
            {
                return this._pd.Converter;
            }
        }


        // Returns the property editor 
        // A translator can overwrite with its own editor.
        public override object GetEditor(Type editorBaseType)
        {
            return this._pd.GetEditor(editorBaseType);
        }

        // Specifies the property is read only.
        public override bool IsReadOnly
        {
            get
            {
                return true;
            }
        }

        public override Type PropertyType
        {
            get
            {
                return this._pd.PropertyType;
            }
        }

        public override bool CanResetValue(object component)
        {
            return this._pd.CanResetValue(component);
        }


        public override object GetValue(object component)
        {
            return this._pd.GetValue(component);
        }

        public override void ResetValue(object component)
        {
            this._pd.ResetValue(component);
        }

        public override void SetValue(object component, object val)
        {
            this._pd.SetValue(component, val);
        }

        // Determines whether a value should be serialized.
        public override bool ShouldSerializeValue(object component)
        {
            bool result = this._pd.ShouldSerializeValue(component);

            if (!result)
            {
                DefaultValueAttribute dva = (DefaultValueAttribute)_pd.Attributes[typeof(DefaultValueAttribute)];
                if (dva != null)
                {
                    result = !Object.Equals(this._pd.GetValue(component), dva.Value);
                }
                else
                {
                    result = true;
                }
            }

            return result;
        }

        // The following Utility methods create a new AttributeCollection
        // by appending the specified attributes to an existing collection.
        static public AttributeCollection AppendAttributeCollection(
            AttributeCollection existing, 
            params Attribute[] newAttrs)
        {
            return new AttributeCollection(AppendAttributes(existing, newAttrs));
        }


        static public Attribute[] AppendAttributes(
            AttributeCollection existing, 
            params Attribute[] newAttrs)
        {
            if (existing == null)
            {
                throw new ArgumentNullException("existing");
            }

            if (newAttrs == null)
            {
                newAttrs = new Attribute[0];
            }

            Attribute[] attributes;

            Attribute[] newArray = new Attribute[existing.Count + newAttrs.Length];
            int actualCount = existing.Count;
            existing.CopyTo(newArray, 0);

            for (int idx = 0; idx < newAttrs.Length; idx++)
            {
                if (newAttrs[idx] == null)
                {
                    throw new ArgumentNullException("newAttrs");
                }

                // Check if this attribute is already in the existing
                // array.  If it is, replace it.
                bool match = false;
                for (int existingIdx = 0; existingIdx < existing.Count; existingIdx++)
                {
                    if (newArray[existingIdx].TypeId.Equals(newAttrs[idx].TypeId))
                    {
                        match = true;
                        newArray[existingIdx] = newAttrs[idx];
                        break;
                    }
                }

                if (!match)
                {
                    newArray[actualCount++] = newAttrs[idx];
                }
            }

            // If some attributes were collapsed, create a new array.
            if (actualCount < newArray.Length)
            {
                attributes = new Attribute[actualCount];
                Array.Copy(newArray, 0, attributes, 0, actualCount);
            }
            else
            {
                attributes = newArray;
            }

            return attributes;
        }
    }
}


In den folgenden Codebeispielen wird gezeigt, wie der SerializeReadOnlyPropertyDescriptor in einem benutzerdefinierten Designer verwendet wird.


using System;
using System.Collections;
using System.ComponentModel;
using System.Text;
using System.Windows.Forms.Design;

namespace ReadOnlyPropertyDescriptorTest
{   
    class DemoControlDesigner : ControlDesigner
    {
        // The PostFilterProperties method replaces the control's 
        // Size property with a read-only Size property by using 
        // the SerializeReadOnlyPropertyDescriptor class.
        protected override void PostFilterProperties(IDictionary properties)
        {
            if (properties.Contains("Size"))
            {
                PropertyDescriptor original = properties["Size"] as PropertyDescriptor;
                SerializeReadOnlyPropertyDescriptor readOnlyDescriptor = 
                    new SerializeReadOnlyPropertyDescriptor(original);

                properties["Size"] = readOnlyDescriptor;
            }

            base.PostFilterProperties(properties);
        }
    }
}


...


using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Text;
using System.Windows.Forms;
using System.Windows.Forms.Design;

namespace ReadOnlyPropertyDescriptorTest
{
    [Designer(typeof(DemoControlDesigner))]
    public class DemoControl : Control
    {
        public DemoControl()
        {

        }
    }
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.