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

Примеры

Следующее консольное приложение создает строки подключения для базы данных Oracle. Код использует OracleConnectionStringBuilder класс для создания строка подключения, а затем передает ConnectionString свойство экземпляра OracleConnectionStringBuilder конструктору класса соединения. В примере также анализируется существующий строка подключения и демонстрируются различные способы управления содержимым строка подключения.

Примечание

В этом примере для демонстрации взаимодействия класса OracleConnectionStringBuilder со строками подключения используется пароль. В приложениях рекомендуется использовать аутентификацию Windows. Если необходимо использовать пароль, то не следует включать в приложение пароли, жестко заданные в коде.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

Комментарии

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

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

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

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

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

Dim builder As 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)  

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"  

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

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

Свойства

BrowsableConnectionString	Устаревшие.. Возвращает или задает значение, указывающее, отображается ли свойство ConnectionString в конструкторах Visual Studio. (Унаследовано от DbConnectionStringBuilder)
ConnectionString	Устаревшие.. Возвращает или задает строку подключения, связанную с этим DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
Count	Устаревшие.. Возвращает текущее количество ключей, содержащихся в свойстве ConnectionString. (Унаследовано от DbConnectionStringBuilder)
DataSource	Устаревшие.. Возвращает или задает имя источника данных Oracle, к которому необходимо подключиться.
Enlist	Устаревшие.. Возвращает или задает значение, которое определяет, добавляет ли автоматически процесс, обслуживающий пул, подключение в контекст текущей транзакции создающего ее потока.
IntegratedSecurity	Устаревшие.. Возвращает или задает значение, которое определяет, заданы ли в подключении "User ID" и "Password" (значение 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	Устаревшие.. Возвращает или задает логическое значение, которое определяет, поддерживает ли клиент возможности 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.

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

• Создание строк подключения