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

Определение

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

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Инициализирует новый экземпляр класса OracleConnectionStringBuilder.

Перегрузки

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

OracleConnectionStringBuilder()

Инициализирует новый экземпляр класса OracleConnectionStringBuilder.

public:
 OracleConnectionStringBuilder();

public OracleConnectionStringBuilder ();

Public Sub New ()

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

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

OracleConnectionStringBuilder(String)

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

public:
 OracleConnectionStringBuilder(System::String ^ connectionString);

public OracleConnectionStringBuilder (string connectionString);

new System.Data.OracleClient.OracleConnectionStringBuilder : string -> System.Data.OracleClient.OracleConnectionStringBuilder

Public Sub New (connectionString As String)

Параметры

connectionString

String

Основа для сведений о внутреннем подключении объекта. Разбито на пары имя-значение. Недопустимое имя ключа вызывает KeyNotFoundException.

Исключения

KeyNotFoundException

Недопустимое имя ключа в строке подключения.

FormatException

Недопустимое значение в строке подключения (в данном случае ожидаемое логическое или числовое значение не было передано).

Примеры

В следующем примере предоставляется простая строка подключения в OracleConnectionStringBuilder конструкторе объекта, а затем выполняется итерация по всем парам "ключ-значение" в объекте . Обратите внимание, что коллекция предоставляет значения по умолчанию для каждого элемента. Также следует отметить, что класс 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()
    {
        try
        {
            string connectString = "Server=OracleDemo;UID=Mary;Pwd=*****";
            Console.WriteLine("Original: " + connectString);
            OracleConnectionStringBuilder builder =
                new OracleConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

' 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()
    Try
      Dim connectString As String = "Server=OracleDemo;UID=Mary;Pwd=*****"
      Console.WriteLine("Original: " & connectString)
      Dim builder As New OracleConnectionStringBuilder(connectString)
      Console.WriteLine("Modified: " & builder.ConnectionString)
      For Each key As String In builder.Keys
        Console.WriteLine(key & "=" & builder.Item(key).ToString)
      Next
      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.Collections.Generic.KeyNotFoundException
      Console.WriteLine("KeyNotFoundException: " & ex.Message)
    Catch ex As System.FormatException
      Console.WriteLine("Format exception: " & ex.Message)
    End Try
  End Sub

End Module

Комментарии

Класс OracleConnectionStringBuilder предоставляет фиксированную внутреннюю коллекцию пар «ключ-значение». Даже если в конструкторе предоставляется только небольшой набор возможных значений строки подключения, объект всегда предоставит значения по умолчанию для каждой пары «ключ-значение». При извлечении ConnectionString свойства объекта строка содержит только пары "ключ-значение", в которых значение отличается от значения по умолчанию для элемента.

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

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