DesignOnlyAttribute Класс

Определение

Пространство имен:

System.ComponentModel

Сборка:

System.ComponentModel.Primitives.dll

Исходный код:

DesignOnlyAttribute.cs

Указывает на возможность задания свойства только во время разработки.

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

Наследование

Object

Attribute

DesignOnlyAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере создается GetLanguage свойство . Свойство помечается .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.
       return 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

В следующем примере возвращается значение DesignOnlyAttribute. Сначала код получает со PropertyDescriptorCollection всеми свойствами объекта . Затем он индексирует в , PropertyDescriptorCollection чтобы найти GetLanguage свойство . Затем он возвращает атрибуты для этого свойства и сохраняет их в переменной атрибутов.

Затем в примере отображается, является ли свойство конструктором только путем извлечения DesignOnlyAttribute из AttributeCollectionи записи его на экран консоли.

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

Комментарии

Элементы, помеченные набором DesignOnlyAttribute , true можно задать только во время разработки. Как правило, эти свойства существуют только во время разработки и не соответствуют реальному свойству объекта во время выполнения.

Элементы, которые либо не имеют атрибута, либо помечены набором DesignOnlyAttribute , false могут быть заданы во время выполнения. Значение по умолчанию — false.

Свойство, для которого DesignOnlyAttribute задано значение , true сериализуется в RESX-файл, а не в InitializeComponent метод .

Дополнительные сведения см. в разделе Атрибуты.

Конструкторы

DesignOnlyAttribute(Boolean)

Инициализирует новый экземпляр класса DesignOnlyAttribute.

Поля

Default	Задает значение по умолчанию для атрибута DesignOnlyAttribute, равное No. Это статическое (static) поле доступно только для чтения.
No	Определяет, что свойство может быть задано во время разработки или во время выполнения. Это статическое (static) поле доступно только для чтения.
Yes	Определяет, что свойство может быть установлено только во время разработки. Это статическое (static) поле доступно только для чтения.

Свойства

IsDesignOnly	Возвращает значение, показывающее возможность задания свойства только во время разработки.
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Возвращает значение, показывающее, равно ли значение данного объекта текущему атрибуту DesignOnlyAttribute.
GetHashCode()	Возвращает хэш-код данного экземпляра.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	Определяет, является ли этот атрибут используемым по умолчанию.
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Attribute
• PropertyDescriptor