DesignOnlyAttribute Klasse

Definition

public ref class DesignOnlyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class DesignOnlyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type DesignOnlyAttribute = class
    inherit Attribute

Public NotInheritable Class DesignOnlyAttribute
Inherits Attribute

Vererbung

Object

Attribute

DesignOnlyAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird eine GetLanguage Eigenschaft erstellt. Die Eigenschaft ist mit einer DesignOnlyAttribute.

public:
   [DesignOnly(true)]
   property CultureInfo^ GetLanguage 
   {
      CultureInfo^ get()
      {
         // Insert code here.
         return myCultureInfo;
      }
      void set( CultureInfo^ value )
      {
         // Insert code here.
      }
   }

[DesignOnly(true)]
public CultureInfo GetLanguage
{
    get =>
        // Insert code here.
        myCultureInfo;
    set
    {
        // Insert code here.
    }
}

<DesignOnly(True)> _
Public Property GetLanguage() As CultureInfo
    Get
        ' Insert code here.
        Return myCultureInfo
    End Get
    Set
        ' Insert code here.
    End Set
End Property

Im nächsten Beispiel wird der Wert der DesignOnlyAttribute. Zuerst ruft der Code eine PropertyDescriptorCollection mit allen Eigenschaften für das Objekt ab. Als Nächstes wird die Eigenschaft indiziert PropertyDescriptorCollection , um die GetLanguage Eigenschaft zu finden. Anschließend werden die Attribute für diese Eigenschaft zurückgegeben und in der Attributvariable gespeichert.

Anschließend wird gedruckt, ob die Eigenschaft designiert ist, indem sie aus dem AttributeCollectionKonsolenbildschirm abgerufen DesignOnlyAttribute und in den Konsolenbildschirm geschrieben wird.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "GetLanguage" ]->Attributes;

/* Prints whether the property is marked as DesignOnly 
by retrieving the DesignOnlyAttribute from the AttributeCollection. */
DesignOnlyAttribute^ myAttribute = dynamic_cast<DesignOnlyAttribute^>(attributes[ DesignOnlyAttribute::typeid ]);
Console::WriteLine( "This property is design only :{0}", myAttribute->IsDesignOnly );

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

/* Prints whether the property is marked as DesignOnly 
 * by retrieving the DesignOnlyAttribute from the AttributeCollection. */
DesignOnlyAttribute myAttribute =
   (DesignOnlyAttribute)attributes[typeof(DesignOnlyAttribute)];
Console.WriteLine("This property is design only :" +
   myAttribute.IsDesignOnly.ToString());

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("GetLanguage").Attributes

' Prints whether the property is marked as DesignOnly 
' by retrieving the DesignOnlyAttribute from the AttributeCollection.
Dim myAttribute As DesignOnlyAttribute = _
    CType(attributes(GetType(DesignOnlyAttribute)), DesignOnlyAttribute)
Console.WriteLine(("This property is design only :" & _
    myAttribute.IsDesignOnly.ToString()))

Hinweise

Elemente, die mit dem DesignOnlyAttribute Satz gekennzeichnet sind, true können nur zur Entwurfszeit festgelegt werden. In der Regel sind diese Eigenschaften nur zur Entwurfszeit vorhanden und entsprechen nicht einer realen Eigenschaft des Objekts zur Laufzeit.

Member, die entweder kein Attribut besitzen oder mit dem Satz gekennzeichnet sind, false können während der DesignOnlyAttribute Laufzeit festgelegt werden. Der Standardwert lautet false.

Eine Eigenschaft, deren DesignOnlyAttribute Wert anstelle true der InitializeComponent Methode in die RESX-Datei serialisiert ist.

Weitere Informationen finden Sie unter Attribute.

Weitere Informationen

• Attribute
• PropertyDescriptor