ConnectionStringEditor 类

定义

命名空间:

System.Web.UI.Design

程序集:

System.Design.dll

为用户界面提供基类，以便在设计时选择和编辑连接字符串属性。

public ref class ConnectionStringEditor : System::Drawing::Design::UITypeEditor

public class ConnectionStringEditor : System.Drawing.Design.UITypeEditor

type ConnectionStringEditor = class
    inherit UITypeEditor

Public Class ConnectionStringEditor
Inherits UITypeEditor

继承

Object

UITypeEditor

ConnectionStringEditor

派生

System.Web.UI.Design.WebControls.SqlDataSourceConnectionStringEditor

示例

下面的代码示例演示如何将 类的 ConnectionStringEditor 实例与自定义控件中包含的属性相关联。 在设计图面中编辑控件属性时， ConnectionStringEditor 类提供用户界面来选择和编辑属性值的连接字符串。

// Define a custom class derived from the SqlDataSource Web control. 
public class SqlDataSourceWithBackup : SqlDataSource
{
    private string _alternateConnectionString;

    // Define an alternate connection string, which could be used
    // as a fallback value if the primary connection string fails.
    
    // The EditorAttribute indicates the property can
    // be edited at design-time with the ConnectionStringEditor class.
    [
      DefaultValue(""),
      EditorAttribute(typeof(System.Web.UI.Design.ConnectionStringEditor),
                     typeof(System.Drawing.Design.UITypeEditor)),
      Category("Data"),
      Description("The alternate connection string.")
    ]
    public string AlternateConnectionString
    {
        get
        {
            return _alternateConnectionString;
        }
        set
        {
            _alternateConnectionString = value;
        }
    }
}

' Define a custom class derived from the SqlDataSource Web control. 
Public Class SqlDataSourceWithBackup
    Inherits SqlDataSource

    Private _alternateConnectionString As String

    ' Define an alternate connection string, which could be used
    ' as a fallback value if the primary connection string fails.

    ' The EditorAttribute indicates the property can
    ' be edited at design-time with the ConnectionStringEditor class.
    <DefaultValue(""), _
     EditorAttribute(GetType(System.Web.UI.Design.ConnectionStringEditor), _
         GetType(System.Drawing.Design.UITypeEditor)), _
     Category("Data"), _
     Description("The alternate connection string.")> _
   Public Property AlternateConnectionString() As String

        Get
            Return _alternateConnectionString
        End Get
        Set(ByVal value As String)
            _alternateConnectionString = value
        End Set
    End Property

End Class

注解

类的 ConnectionStringEditor 实例是在 UITypeEditor 设计时可用于选择和编辑连接字符串表达式以及将表达式分配给控件属性的对象。 例如， SqlDataSource 控件在设计时使用 ConnectionStringEditor 类来设置 属性的值 ConnectionString 。

EditorAttribute使用 特性将 与 属性相关联ConnectionStringEditor。 在设计图面上编辑关联的属性时，设计器主机将调用 EditValue 方法。 方法 EditValue 显示用于生成连接字符串表达式的用户界面，并返回用户选择的连接字符串。 方法 GetEditStyle 指示用户界面的显示样式。

构造函数

ConnectionStringEditor()

初始化 ConnectionStringEditor 类的新实例。

属性

IsDropDownResizable

获取一个值，该值指示是否应由用户调整下拉编辑器的大小。 (继承自 UITypeEditor)

方法

EditValue(IServiceProvider, Object)	使用 GetEditStyle() 方法所指示的编辑器样式编辑指定对象的值。 (继承自 UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)	使用指定的服务提供程序和上下文编辑指定对象的值。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEditStyle()	获取由 EditValue(IServiceProvider, Object) 方法使用的编辑器样式。 (继承自 UITypeEditor)
GetEditStyle(ITypeDescriptorContext)	返回与指定上下文的连接字符串编辑器关联的编辑样式。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetPaintValueSupported()	指示该编辑器是否支持绘制对象值的表示形式。 (继承自 UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)	指示指定的上下文是否支持在指定的上下文内绘制对象值的表示形式。 (继承自 UITypeEditor)
GetProviderName(Object)	返回提供的 ConnectionStringEditor 类实例的提供程序名称。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
PaintValue(Object, Graphics, Rectangle)	将指定对象值表示形式绘制到指定的画布上。 (继承自 UITypeEditor)
PaintValue(PaintValueEventArgs)	使用指定的 PaintValueEventArgs 绘制某个对象的值的表示形式。 (继承自 UITypeEditor)
SetProviderName(Object, DesignerDataConnection)	将提供程序名称放在 ConnectionStringEditor 类的指定实例上。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• UITypeEditor
• ConnectionStringsExpressionEditor
• SqlDataSource
• SqlDataSourceDesigner
• EditorAttribute
• ADO.NET 中的连接字符串