OracleConnectionStringBuilder Класс

Определение

Пространство имен:

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Внимание!

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Предоставляет простой способ создания и управления содержимым строк подключения, используемых классом OracleConnection.

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder

Наследование

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Атрибуты

TypeConverterAttribute ObsoleteAttribute

Комментарии

Этот тип устарел и будет удален в будущей версии .NET Framework. Дополнительные сведения см. в разделе Oracle и ADO.NET.

Построитель строк подключения позволяет разработчикам программно создавать синтаксически правильные строки подключения, а также анализировать и перестроить существующие строки подключения, используя свойства и методы класса. Построитель строк подключения предоставляет строго типизированные свойства, соответствующие известным парам "ключ-значение", разрешенным Oracle. Класс OracleConnectionStringBuilder реализует интерфейс ICustomTypeDescriptor. Это означает, что класс работает с конструкторами Visual Studio .NET во время разработки. Когда разработчики используют конструктор для создания строго типизированных DataSets и строго типизированных подключений в Visual Studio .NET, класс строго типизированного конструктора строк подключения будет отображать свойства, связанные с его типом, и также будут иметь преобразователи, которые могут сопоставлять общие значения известных ключей.

Разработчики, необходимые для создания строк подключения в рамках приложений, могут использовать класс OracleConnectionStringBuilder для создания и изменения строк подключения. Класс OracleConnectionStringBuilder также упрощает управление строками подключения, хранящимися в файле конфигурации приложения.

OracleConnectionStringBuilder выполняет проверку допустимых пар "ключ-значение". Поэтому этот класс нельзя использовать для создания недопустимых строк подключения. При попытке добавить недопустимые пары возникает исключение. Класс OracleConnectionStringBuilder поддерживает фиксированную коллекцию синонимов и при необходимости может выполнять необходимый перевод из синонима в соответствующее известное имя ключа. Например, при использовании свойства Item[] для получения значения можно указать строку, содержащую любой синоним нужного ключа. Полный список допустимых синонимов см. в свойстве Item[].

OracleConnectionStringBuilder обрабатывает попытки вставки вредоносных записей. Например, следующий код, используя свойство Item[] по умолчанию (индексатор в C#), правильно экранирует пару вложенных ключей и значений.

Dim builder As New System.Data. _
    OracleClient.OracleConnectionStringBuilder
builder("Data Source") = "OracleDemo;NewValue=Bad"
builder("Integrated Security") = True
builder("User ID") = "Mary;NewValue=Bad"
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)

System.Data.OracleClient.OracleConnectionStringBuilder builder =
   new System.Data.OracleClient.OracleConnectionStringBuilder();
builder["Data Source"] = "OracleDemo";
builder["integrated Security"] = true;
builder["User ID"] = "Mary;NewValue=Bad";
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);

Результатом является следующая строка подключения, которая обрабатывает недопустимое значение безопасным образом, заключив значение идентификатора пользователя в кавычки:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"

Предупреждение

Корпорация Майкрософт не рекомендует напрямую предоставлять имя пользователя и пароль, так как это небезопасный шаблон. По возможности используйте более безопасные потоки проверки подлинности, такие как управляемые удостоверения для ресурсов Azureили проверки подлинности Windows для SQL Server.

Конструкторы

OracleConnectionStringBuilder()	Устаревшие.. Инициализирует новый экземпляр класса OracleConnectionStringBuilder.
OracleConnectionStringBuilder(String)	Устаревшие.. Инициализирует новый экземпляр класса OracleConnectionStringBuilder. Указанная строка подключения предоставляет данные для внутренних сведений о подключении экземпляра.

Свойства

BrowsableConnectionString	Устаревшие.. Возвращает или задает значение, указывающее, отображается ли свойство ConnectionString в конструкторах Visual Studio. (Унаследовано от DbConnectionStringBuilder)
ConnectionString	Устаревшие.. Возвращает или задает строку подключения, связанную с DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
Count	Устаревшие.. Возвращает текущее количество ключей, содержащихся в свойстве ConnectionString. (Унаследовано от DbConnectionStringBuilder)
DataSource	Устаревшие.. Возвращает или задает имя источника данных Oracle для подключения.
Enlist	Устаревшие.. Возвращает или задает значение, указывающее, автоматически ли пул заверяет соединение в текущем контексте транзакции потока создания.
IntegratedSecurity	Устаревшие.. Возвращает или задает значение, указывающее, указаны ли идентификатор пользователя и пароль в соединении (когда false) или используются ли текущие учетные данные учетной записи Windows для проверки подлинности (при true).
IsFixedSize	Устаревшие.. Возвращает значение, указывающее, имеет ли OracleConnectionStringBuilder фиксированный размер.
IsReadOnly	Устаревшие.. Возвращает значение, указывающее, доступен ли DbConnectionStringBuilder только для чтения. (Унаследовано от DbConnectionStringBuilder)
Item[String]	Устаревшие.. Возвращает или задает значение, связанное с указанным ключом. В C#это свойство является индексатором.
Keys	Устаревшие.. Получает ICollection, содержащий ключи в OracleConnectionStringBuilder.
LoadBalanceTimeout	Устаревшие.. Возвращает или задает минимальное время (в секундах) для подключения к пулу соединений перед удалением.
MaxPoolSize	Устаревшие.. Возвращает или задает максимальное количество подключений, разрешенных в пуле подключений для этой конкретной строки подключения.
MinPoolSize	Устаревшие.. Возвращает или задает минимальное количество подключений, разрешенных в пуле подключений для этой конкретной строки подключения.
OmitOracleConnectionName	Устаревшие.. Возвращает или задает флаг, который включает откат транзакций в более ранних версиях Oracle (до 8.1.7.4.1).
Password	Устаревшие.. Возвращает или задает пароль для учетной записи Oracle.
PersistSecurityInfo	Устаревшие.. Возвращает или задает логическое значение, указывающее, не возвращается ли конфиденциальная информация безопасности, например пароль, не возвращается в составе подключения, если подключение открыто или когда-либо находилось в открытом состоянии.
Pooling	Устаревшие.. Возвращает или задает логическое значение, указывающее, будет ли соединение объединяться в пул или будет ли каждое подключение явно открываться при каждом запросе подключения.
Unicode	Устаревшие.. Возвращает или задает логическое значение, указывающее, поддерживает ли клиент функциональные возможности Юникода, доступные в более поздних клиентах Oracle, или если он не учитывает Юникод.
UserID	Устаревшие.. Возвращает или задает идентификатор пользователя, используемый при подключении к Oracle.
Values	Устаревшие.. Получает ICollection, содержащий значения в OracleConnectionStringBuilder.

Методы

Add(String, Object)	Устаревшие.. Добавляет запись с указанным ключом и значением в DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
Clear()	Устаревшие.. Очищает содержимое экземпляра OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Устаревшие.. Очищает коллекцию объектов PropertyDescriptor в связанном DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
ContainsKey(String)	Устаревшие.. Определяет, содержит ли OracleConnectionStringBuilder определенный ключ.
Equals(Object)	Устаревшие.. Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
EquivalentTo(DbConnectionStringBuilder)	Устаревшие.. Сравнивает сведения о подключении в этом объекте DbConnectionStringBuilder с сведениями о соединении в предоставленном объекте. (Унаследовано от DbConnectionStringBuilder)
GetHashCode()	Устаревшие.. Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetProperties(Hashtable)	Устаревшие.. Заполняет предоставленный Hashtable сведениями обо всех свойствах этого DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
GetType()	Устаревшие.. Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Устаревшие.. Создает неглубокую копию текущей Object. (Унаследовано от Object)
Remove(String)	Устаревшие.. Удаляет запись с указанным ключом из экземпляра OracleConnectionStringBuilder.
ShouldSerialize(String)	Устаревшие.. Указывает, существует ли указанный ключ в этом OracleConnectionStringBuilder экземпляре.
ToString()	Устаревшие.. Возвращает строку подключения, связанную с этой DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
TryGetValue(String, Object)	Устаревшие.. Извлекает значение, соответствующее предоставленному ключу из этой OracleConnectionStringBuilder.

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)	Устаревшие.. Копирует элементы ICollection в Array, начиная с определенного индекса Array. (Унаследовано от DbConnectionStringBuilder)
ICollection.IsSynchronized	Устаревшие.. Возвращает значение, указывающее, синхронизирован ли доступ к ICollection (потокобезопасный). (Унаследовано от DbConnectionStringBuilder)
ICollection.SyncRoot	Устаревшие.. Получает объект, который можно использовать для синхронизации доступа к ICollection. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Устаревшие.. Возвращает коллекцию настраиваемых атрибутов для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Устаревшие.. Возвращает имя класса этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Устаревшие.. Возвращает имя этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Устаревшие.. Возвращает преобразователь типов для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Устаревшие.. Возвращает событие по умолчанию для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Устаревшие.. Возвращает свойство по умолчанию для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Устаревшие.. Возвращает редактор указанного типа для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Устаревшие.. Возвращает события для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Устаревшие.. Возвращает события для этого экземпляра компонента, используя указанный массив атрибутов в качестве фильтра. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Устаревшие.. Возвращает свойства для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Устаревшие.. Возвращает свойства для этого экземпляра компонента с помощью массива атрибутов в качестве фильтра. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Устаревшие.. Возвращает объект, содержащий свойство, описанное указанным дескриптором свойства. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Устаревшие.. Добавляет элемент с предоставленным ключом и значением в объект IDictionary. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Contains(Object)	Устаревшие.. Определяет, содержит ли объект IDictionary элемент с указанным ключом. (Унаследовано от DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Устаревшие.. Возвращает объект IDictionaryEnumerator для объекта IDictionary. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Item[Object]	Устаревшие.. Возвращает или задает элемент с указанным ключом. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Remove(Object)	Устаревшие.. Удаляет элемент с указанным ключом из объекта IDictionary. (Унаследовано от DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Устаревшие.. Возвращает перечислитель, который выполняет итерацию по коллекции. (Унаследовано от DbConnectionStringBuilder)

Методы расширения

Cast<TResult>(IEnumerable)	Устаревшие.. Приведение элементов IEnumerable к указанному типу.
OfType<TResult>(IEnumerable)	Устаревшие.. Фильтрует элементы IEnumerable на основе указанного типа.
AsParallel(IEnumerable)	Устаревшие.. Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Устаревшие.. Преобразует IEnumerable в IQueryable.

См. также раздел

• сборке строк подключения