ConnectionStringEditor Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет базовый класс для пользовательского интерфейса для выбора и изменения свойства строки подключения во время разработки.
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
- Наследование
- Производный
Примеры
В следующем примере кода показано, как связать экземпляр 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) |