ConnectionStringEditor クラス

.NET Framework クラス ライブラリ リファレンス

ConnectionStringEditor クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

デザイン時に接続文字列プロパティを選択および編集するためのユーザー インターフェイスの基本クラスを提供します。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Class ConnectionStringEditor
    Inherits UITypeEditor

Visual Basic (使用法)

Dim instance As ConnectionStringEditor

C#

public class ConnectionStringEditor : UITypeEditor

C++

public ref class ConnectionStringEditor : public
 UITypeEditor

J#

public class ConnectionStringEditor extends
 UITypeEditor

JScript

public class ConnectionStringEditor extends
 UITypeEditor

解説

ConnectionStringEditor クラスのインスタンスは、デザイン時に接続文字列式を選択および編集し、その式をコントロール プロパティに割り当てるために使用できる UITypeEditor オブジェクトです。たとえば、SqlDataSource コントロールは、デザイン時に ConnectionStringEditor クラスを使用し、ConnectionString プロパティの値を設定します。

ConnectionStringEditor とプロパティとを関連付けるには、EditorAttribute 属性を使用します。関連付けられたプロパティをデザイン サーフェイスで編集する場合、デザイナ ホストによって EditValue メソッドが呼び出されます。EditValue メソッドは、接続文字列式を作成するためのユーザー インターフェイスを表示し、ユーザーが選択した接続文字列を返します。GetEditStyle メソッドは、ユーザー インターフェイスの表示スタイルを示します。

使用例

カスタム コントロールに格納されたプロパティで ConnectionStringEditor クラスのインスタンスにアクセスする方法を次のコード例に示します。デザイン サーフェイスでコントロールのプロパティを編集する場合、ConnectionStringEditor クラスは、プロパティ値の接続文字列を選択および編集するためのユーザー インターフェイスを提供します。

Visual Basic

' 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

C#

// 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;
        }

    }
    
}

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを操作するために必要なアクセス許可)UnmanagedCode (関連する列挙体)

継承階層

System.Object
   System.Drawing.Design.UITypeEditor
    System.Web.UI.Design.ConnectionStringEditor
       System.Web.UI.Design.WebControls.SqlDataSourceConnectionStringEditor

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ConnectionStringEditor メンバ
System.Web.UI.Design 名前空間
UITypeEditor
ConnectionStringsExpressionEditor
SqlDataSource
SqlDataSourceDesigner
EditorAttribute
その他の技術情報
接続文字列の使用