DefaultPropertyAttribute 类

项目
08/17/2007

指定组件的默认属性。

**命名空间:**System.ComponentModel
**程序集:**System（在 system.dll 中）

语法

声明
<AttributeUsageAttribute(AttributeTargets.Class)> _
Public NotInheritable Class DefaultPropertyAttribute
    Inherits Attribute
用法
Dim instance As DefaultPropertyAttribute

[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class DefaultPropertyAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class)] 
public ref class DefaultPropertyAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class DefaultPropertyAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Class) 
public final class DefaultPropertyAttribute extends Attribute

备注

使用 Name 属性来获取默认属性的名称。

有关更多信息，请参见属性 (Attribute) 概述和利用属性扩展元数据。

主题	位置
演练：开发和使用自定义服务器控件	创作 ASP.NET 控件
为 ASP.NET 1.1 开发自定义数据绑定 Web 服务器控件	创作 ASP.NET 控件
为 ASP.NET 2.0 开发自定义数据绑定 Web 服务器控件	创作 ASP.NET 控件
演练：为 ASP.NET 2.0 创建自定义数据绑定 ASP.NET Web 控件	创作 ASP.NET 控件
演练：为 ASP.NET 1.1 创建自定义数据绑定 ASP.NET Web 控件	创作 ASP.NET 控件
演练：开发和使用自定义服务器控件	使用 Visual Web Developer 生成应用程序
为 ASP.NET 2.0 开发自定义数据绑定 Web 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：为 ASP.NET 2.0 创建自定义数据绑定 ASP.NET Web 控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
为 ASP.NET 1.1 开发自定义数据绑定 Web 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
为 ASP.NET 2.0 开发自定义数据绑定 Web 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：为 ASP.NET 2.0 创建自定义数据绑定 ASP.NET Web 控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：为 ASP.NET 1.1 创建自定义数据绑定 ASP.NET Web 控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
为 ASP.NET 1.1 开发自定义数据绑定 Web 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：为 ASP.NET 1.1 创建自定义数据绑定 ASP.NET Web 控件	在 Visual Studio 中生成 ASP .NET Web 应用程序

示例

下面的示例定义名为 MyControl 的控件。该类标记为 DefaultPropertyAttribute，它指定 MyProperty 作为默认属性。

<DefaultProperty("MyProperty")> _
Public Class MyControl
    Inherits Control

    Public Property MyProperty() As Integer
        Get
            ' Insert code here.
            Return 0
        End Get
        Set
            ' Insert code here.
        End Set 
    End Property
    ' Insert any additional code.
End Class 'MyControl

[DefaultProperty("MyProperty")]
 public class MyControl : Control {
 
    public int MyProperty {
       get {
          // Insert code here.
          return 0;
       }
       set {
          // Insert code here.
       }
    }
 
    // Insert any additional code.
 
 }

[DefaultProperty("MyProperty")]
ref class MyControl: public Control
{
public:

   property int MyProperty 
   {
      int get()
      {
         // Insert code here.
         return 0;
      }

      void set( int value )
      {
         // Insert code here.
      }
   }
   // Insert any additional code.
};

/** @attribute DefaultProperty("MyProperty")
 */
public static class MyControl extends Control
{
    /** @property 
     */
    public int get_MyProperty()
    {
        // Insert code here.
        return 0;
    } //get_MyProperty

    /** @property 
     */
    public void set_MyProperty(int value)
    {
        // Insert code here.
    } //set_MyProperty

    // Insert any additional code.

} //MyControl

下一个示例创建 MyControl 的实例。然后它获取该类的属性，提取 DefaultPropertyAttribute，并输出默认属性的名称。

Public Shared Function Main() As Integer
    ' Creates a new control.
    Dim myNewControl As New MyControl()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewControl)
    
    ' Prints the name of the default property by retrieving the
    ' DefaultPropertyAttribute from the AttributeCollection. 
    Dim myAttribute As DefaultPropertyAttribute = _
        CType(attributes(GetType(DefaultPropertyAttribute)), DefaultPropertyAttribute)
    Console.WriteLine(("The default property is: " + myAttribute.Name))
    Return 0
End Function 'Main

public static int Main() {
    // Creates a new control.
    MyControl myNewControl = new MyControl();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewControl);
 
    /* Prints the name of the default property by retrieving the 
     * DefaultPropertyAttribute from the AttributeCollection. */
    DefaultPropertyAttribute myAttribute = 
       (DefaultPropertyAttribute)attributes[typeof(DefaultPropertyAttribute)];
    Console.WriteLine("The default property is: " + myAttribute.Name);
  
    return 0;
 }

int main()
{
   // Creates a new control.
   Form1::MyControl^ myNewControl = gcnew Form1::MyControl;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewControl );

   /* Prints the name of the default property by retrieving the 
       * DefaultPropertyAttribute from the AttributeCollection. */
   DefaultPropertyAttribute^ myAttribute = dynamic_cast<DefaultPropertyAttribute^>(attributes[ DefaultPropertyAttribute::typeid ]);
   Console::WriteLine( "The default property is: {0}", myAttribute->Name );
   return 0;
}

public static void main(String[] args)
{
    // Creates a new control.        
    MyControl myNewControl = new MyControl();

    // Gets the attributes for the collection.
    AttributeCollection attributes = 
        TypeDescriptor.GetAttributes(myNewControl);

    /* Prints the name of the default property by retrieving the 
       DefaultPropertyAttribute from the AttributeCollection. 
     */
    DefaultPropertyAttribute myAttribute = 
        (DefaultPropertyAttribute)(attributes.get_Item(
        DefaultPropertyAttribute.class.ToType()));

    Console.WriteLine("The default property is: " 
        + myAttribute.get_Name());
    
} //main

继承层次结构

System.Object
System.Attribute
System.ComponentModel.DefaultPropertyAttribute

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

通过

DefaultPropertyAttribute 类

语法

备注

示例

继承层次结构

线程安全

平台

版本信息

.NET Framework

请参见

参考

其他资源