DefaultValueAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt den Standardwert für eine Eigenschaft an.
public ref class DefaultValueAttribute : Attribute
public ref class DefaultValueAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public class DefaultValueAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class DefaultValueAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All)>]
type DefaultValueAttribute = class
inherit Attribute
Public Class DefaultValueAttribute
Inherits Attribute
Public NotInheritable Class DefaultValueAttribute
Inherits Attribute
- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel wird der Standardwert auf MyProperty .false
private:
bool _myVal;
public:
[DefaultValue(false)]
property bool MyProperty
{
bool get()
{
return _myVal;
}
void set( bool value )
{
_myVal = value;
}
}
[DefaultValue(false)]
public bool MyProperty { get; set; }
Private _myVar As Boolean = False
<DefaultValue(False)>
Public Property MyProperty() As Boolean
Get
Return _myVar
End Get
Set
_myVar = Value
End Set
End Property
Im nächsten Beispiel wird der Standardwert von MyProperty. Zuerst ruft der Code eine PropertyDescriptorCollection mit allen Eigenschaften für das Objekt ab. Als Nächstes wird es indiziert PropertyDescriptorCollection , um abzurufen MyProperty. Anschließend werden die Attribute für diese Eigenschaft zurückgegeben und in der Attributvariable gespeichert.
Anschließend wird der Standardwert gedruckt, indem der DefaultValueAttribute Name aus dem AttributeCollectionKonsolenbildschirm abgerufen und in den Konsolenbildschirm geschrieben wird.
// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyProperty" ]->Attributes;
/* Prints the default value by retrieving the DefaultValueAttribute
* from the AttributeCollection. */
DefaultValueAttribute^ myAttribute = dynamic_cast<DefaultValueAttribute^>(attributes[ DefaultValueAttribute::typeid ]);
Console::WriteLine( "The default value is: {0}", myAttribute->Value );
// Gets the attributes for the property.
AttributeCollection attributes =
TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;
/* Prints the default value by retrieving the DefaultValueAttribute
* from the AttributeCollection. */
DefaultValueAttribute myAttribute =
(DefaultValueAttribute)attributes[typeof(DefaultValueAttribute)];
Console.WriteLine("The default value is: " + myAttribute.Value.ToString());
' Gets the attributes for the property.
Dim attributes As AttributeCollection =
TypeDescriptor.GetProperties(Me)("MyProperty").Attributes
' Prints the default value by retrieving the DefaultValueAttribute
' from the AttributeCollection.
Dim myAttribute As DefaultValueAttribute =
CType(attributes(GetType(DefaultValueAttribute)), DefaultValueAttribute)
Console.WriteLine(("The default value is: " & myAttribute.Value.ToString()))
Hinweise
Sie können einen DefaultValueAttribute beliebigen Wert erstellen. Der Standardwert eines Elements ist in der Regel sein Anfangswert. Ein visueller Designer kann den Standardwert verwenden, um den Wert des Elements zurückzusetzen. Codegeneratoren können auch die Standardwerte verwenden, um zu bestimmen, ob Code für das Element generiert werden soll.
Note
Ein DefaultValueAttribute Element wird nicht automatisch mit dem Wert des Attributs initialisiert. Sie müssen den Anfangswert im Code festlegen.
Weitere Informationen finden Sie unter Attribute.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DefaultValueAttribute(Boolean) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einem Boolean Wert. |
| DefaultValueAttribute(Byte) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einer 8-Bit-ganzzahl ohne Vorzeichen. |
| DefaultValueAttribute(Char) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mithilfe eines Unicode-Zeichens. |
| DefaultValueAttribute(Double) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mithilfe einer Gleitkommazahl mit doppelter Genauigkeit. |
| DefaultValueAttribute(Int16) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einer ganzzahligen 16-Bit-Vorzeichen. |
| DefaultValueAttribute(Int32) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mithilfe einer 32-Bit-ganzzahligen Vorzeichen. |
| DefaultValueAttribute(Int64) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einer ganzzahligen 64-Bit-Vorzeichen. |
| DefaultValueAttribute(Object) |
Initialisiert eine neue Instanz der DefaultValueAttribute-Klasse. |
| DefaultValueAttribute(SByte) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einem SByte Wert. |
| DefaultValueAttribute(Single) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einer Gleitkommazahl mit einfacher Genauigkeit. |
| DefaultValueAttribute(String) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mithilfe einer String. |
| DefaultValueAttribute(Type, String) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse, konvertiert den angegebenen Wert in den angegebenen Typ und verwendet eine invariante Kultur als Übersetzungskontext. |
| DefaultValueAttribute(UInt16) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einem UInt16 Wert. |
| DefaultValueAttribute(UInt32) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einem UInt32 Wert. |
| DefaultValueAttribute(UInt64) |
Initialisiert eine neue Instanz der DefaultValueAttribute Klasse mit einem UInt64 Wert. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| TypeId |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute) |
| Value |
Ruft den Standardwert der Eigenschaft ab, an die dieses Attribut gebunden ist. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Gibt zurück, ob der Wert des angegebenen Objekts dem aktuellen DefaultValueAttributeentspricht. |
| GetHashCode() |
Gibt den Hashcode für diese Instanz zurück. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsDefaultAttribute() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute) |
| Match(Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SetValue(Object) |
Legt den Standardwert für die Eigenschaft fest, an die dieses Attribut gebunden ist. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute) |