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)

Применяется к