DesignOnlyAttribute Class

Definition

디자인 타임에만 속성을 설정할 수 있는지 여부를 지정 합니다.Specifies whether a property can only be set at design time.

public ref class DesignOnlyAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class DesignOnlyAttribute : Attribute
public sealed class DesignOnlyAttribute : Attribute
type DesignOnlyAttribute = class
    inherit Attribute
Public NotInheritable Class DesignOnlyAttribute
Inherits Attribute
Inheritance
DesignOnlyAttribute
Attributes

Examples

다음 예에서는 GetLanguage 속성을 만듭니다.The following example creates a GetLanguage property. 속성이 DesignOnlyAttribute표시 됩니다.The property is marked with a 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값을 가져옵니다.The next example gets the value of the DesignOnlyAttribute. 먼저 코드를 가져옵니다는 PropertyDescriptorCollection 개체에 대 한 모든 속성을 사용 하 여 합니다.First the code gets a PropertyDescriptorCollection with all the properties for the object. 그런 다음 PropertyDescriptorCollection으로 인덱싱하여 GetLanguage 속성을 찾습니다.Next it indexes into the PropertyDescriptorCollection to find the GetLanguage property. 그런 다음이 속성에 대 한 특성을 반환 하 고 특성 변수에 저장 합니다.Then it returns the attributes for this property and saves them in the attributes variable.

그런 다음이 예제에서는 AttributeCollection에서 DesignOnlyAttribute를 검색 하 여 콘솔 화면에 기록 하는 방법 으로만 속성을 디자인 하는지 여부를 출력 합니다.The example then prints whether the property is design only by retrieving DesignOnlyAttribute from the AttributeCollection, and writing it to the console screen.

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

Remarks

true로 설정 된 DesignOnlyAttribute 표시 된 멤버는 디자인 타임에만 설정할 수 있습니다.Members marked with the DesignOnlyAttribute set to true can be set only at design time. 일반적으로 이러한 속성 디자인 타임에만 존재 하 고 런타임 시의 실제 속성 개체에 일치 하지 않습니다.Typically, these properties exist only at design time and do not correspond to a real property on the object at run time.

특성이 없거나 false로 설정 된 DesignOnlyAttribute 표시 된 멤버는 런타임에 설정할 수 있습니다.Members that either have no attribute or are marked with the DesignOnlyAttribute set to false can be set during run time. 기본값은 false입니다.The default is false.

DesignOnlyAttributetrue로 설정 된 속성의 값은 InitializeComponent 메서드 대신 .resx 파일로 serialize 됩니다.A property with the DesignOnlyAttribute set to true has its value serialized to the .resx file instead of the InitializeComponent method.

자세한 내용은 특성을 참조하세요.For more information, see Attributes.

Constructors

DesignOnlyAttribute(Boolean) DesignOnlyAttribute 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DesignOnlyAttribute class.

Fields

Default

DesignOnlyAttribute의 기본값인 No을 지정합니다.Specifies the default value for the DesignOnlyAttribute, which is No. static 필드는 읽기 전용입니다.This static field is read-only.

No

디자인 타임 또는 런타임에 속성을 설정할 수 있습니다를 지정 합니다.Specifies that a property can be set at design time or at run time. static 필드는 읽기 전용입니다.This static field is read-only.

Yes

디자인 타임에만 속성을 설정할 수 있는지를 지정 합니다.Specifies that a property can be set only at design time. static 필드는 읽기 전용입니다.This static field is read-only.

Properties

IsDesignOnly

디자인 타임에만 속성을 설정할 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether a property can be set only at design time.

TypeId

파생 클래스에서 구현될 때 이 Attribute의 고유 식별자를 가져옵니다.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Methods

Equals(Object)

주어진 개체의 값이 현재 DesignOnlyAttribute와 같은지 여부를 반환합니다.Returns whether the value of the given object is equal to the current DesignOnlyAttribute.

GetHashCode()

이 인스턴스에 대한 해시 코드를 반환합니다.Returns the hash code for this instance.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

이 특성이 기본값 인지 여부를 확인 합니다.Determines if this attribute is the default.

IsDefaultAttribute()

파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object)

파생된 클래스에서 재정의할 경우,이 인스턴스가 지정된 된 개체와 같은지 여부를 나타내는 값을 반환 합니다.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Applies to

See also