BrowsableAttribute-Klasse

Ein visueller Designer zeigt i. d. R. im Eigenschaftenfenster die Member an, die entweder kein durchsuchbares Attribut aufweisen oder mit dem browsable-Parameter des BrowsableAttribute-Konstruktors mit dem Wert true markiert sind. Diese Member können zur Entwurfszeit geändert werden. Member, bei denen der browsable-Parameter des BrowsableAttribute-Konstruktors auf false festgelegt ist, sind für die Bearbeitung zur Entwurfszeit nicht geeignet. Sie werden deshalb nicht in einem visuellen Designer angezeigt. Die Standardeinstellung ist true.

Hinweis
Wenn Sie eine Eigenschaft mit Browsable(true) markieren, wird dieses Attribut auf den konstanten Member Yes festgelegt. Bei einer mit Browsable(false) markierten Eigenschaft lautet der Wert No. Wenn Sie den Wert im Code überprüfen, müssen Sie dieses Attribut daher als BrowsableAttribute.Yes oder BrowsableAttribute.No angeben.

Weitere Informationen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Im folgenden Beispiel wird eine Eigenschaft als browsebar markiert.

[Browsable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }

Im folgenden Beispiel wird veranschaulicht, wie der Wert von BrowsableAttribute für MyProperty überprüft wird. Zunächst wird im Code eine PropertyDescriptorCollection mit allen Eigenschaften für das Objekt abgerufen. Anschließend wird im Code MyProperty über einen Index der PropertyDescriptorCollection abgerufen. Die Attribute für diese Eigenschaft werden zurückgegeben und in der Variablen attributes gespeichert.

Im Beispiel werden zwei verschiedene Möglichkeiten zum Überprüfen des Werts von BrowsableAttribute gezeigt. Im zweiten Codefragment wird die Equals-Methode aufgerufen. Im letzten Codefragment wird der Wert anhand der Browsable-Eigenschaft überprüft.

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;

 // Checks to see if the value of the BrowsableAttribute is Yes.
 if(attributes[typeof(BrowsableAttribute)].Equals(BrowsableAttribute.Yes)) {
    // Insert code here.
 }

 // This is another way to see whether the property is browsable.
 BrowsableAttribute myAttribute = 
    (BrowsableAttribute)attributes[typeof(BrowsableAttribute)];
 if(myAttribute.Browsable) {
    // Insert code here.
 }

Verwenden Sie zur Prüfung folgenden Code, wenn Sie eine Klasse mit dem BrowsableAttribute markiert haben:

AttributeCollection attributes = 
    TypeDescriptor.GetAttributes(MyProperty);
 if(attributes[typeof(BrowsableAttribute)].Equals(BrowsableAttribute.Yes)) {
    // Insert code here.
 }

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz