OracleConnection.ConnectionString Właściwość

Definicja

Przestrzeń nazw:

System.Data.OracleClient

Zestaw:

System.Data.OracleClient.dll

Pobiera lub ustawia ciąg używany do otwierania bazy danych Oracle.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Wartość właściwości

String

Parametry połączenia Oracle, który zawiera ustawienia, takie jak nazwa serwera, potrzebne do nawiązania połączenia początkowego. Wartością domyślną jest ciąg pusty ("").

Atrybuty

SettingsBindableAttribute

Przykłady

Poniższy przykład tworzy obiekt OracleConnection i ustawia niektóre jego właściwości w parametry połączenia.

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}

Public Sub CreateOracleConnection()
    Dim connectionString As String = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub

Uwagi

Parametr ConnectionString można ustawić tylko wtedy, gdy połączenie jest zamknięte.

Możesz użyć ConnectionString właściwości , aby nawiązać połączenie z bazą danych. Poniższy przykład ilustruje typowy parametry połączenia.

"Data Source=Oracle8i;Integrated Security=yes"  

Wiele ustawień określonych w ciągu ma odpowiednie właściwości tylko do odczytu (na przykład , Data Source=MyServerktóre odpowiadają DataSource właściwości ). Po ustawieniu parametry połączenia wszystkie te właściwości zostaną zaktualizowane, chyba że zostanie wykryty błąd, w tym przypadku żadna z właściwości nie zostanie zaktualizowana. OracleConnection właściwości zwracają tylko ustawienia domyślne lub te ustawienia określone w obiekcie ConnectionString.

Zresetowanie elementu dla zamkniętego połączenia spowoduje zresetowanie ConnectionString wszystkich wartości parametry połączenia (i powiązanych właściwości), w tym hasła.

Parametry połączenia jest analizowana natychmiast po ustawieniu. Jeśli analiza ujawnia błędy w składni, generowany jest wyjątek czasu wykonywania, taki jak ArgumentException, . Inne błędy można znaleźć tylko wtedy, gdy zostanie podjęta próba otwarcia połączenia.

Podstawowy format parametry połączenia to seria par słów kluczowych/wartości rozdzielonych średnikami. Znak równości (=) łączy każde słowo kluczowe i jego wartość. Aby uwzględnić wartości zawierające średnik, znak pojedynczego cudzysłowu lub znak podwójnego cudzysłowu, wartość musi być ujęta w cudzysłów podwójnych. Jeśli wartość zawiera zarówno średnik, jak i znak podwójnego cudzysłowu, wartość może być ujęta w apostrofy. Pojedynczy cudzysłów jest również przydatny, jeśli wartość zaczyna się od znaku podwójnego cudzysłowu. Z drugiej strony podwójny cudzysłów można użyć, jeśli wartość zaczyna się od pojedynczego cudzysłowu. Jeśli wartość zawiera znaki pojedynczego cudzysłowu i podwójnego cudzysłowu, znak cudzysłowu używany do ujęć wartość musi zostać podwojony za każdym razem, gdy wystąpi w ramach wartości.

Aby uwzględnić poprzednie lub końcowe spacje w wartości ciągu, wartość musi być ujęta w cudzysłów pojedynczych lub podwójnych cudzysłowów. Wszystkie wiodące lub końcowe spacje wokół liczb całkowitych, logicznych lub wyliczeń są ignorowane, nawet jeśli są ujęte w cudzysłów. Jednak spacje w obrębie słowa kluczowego literału ciągu lub wartości są zachowywane. Cudzysłowy pojedyncze lub podwójne mogą być używane w parametry połączenia bez użycia ograniczników, chyba że znak cudzysłowu jest pierwszym lub ostatnim znakiem w wartości, na przykład Data Source= my'Server lub Data Source= my"Server.

Aby dołączyć znak równości (=) do słowa kluczowego lub wartości, musi być poprzedzony innym znakiem równości. Na przykład w hipotetycznej parametry połączenia

"key==word=value"  

słowo kluczowe to "key=word", a wartość to "value".

Jeśli określone słowo kluczowe w parze słowa kluczowego/wartości występuje więcej niż raz w parametry połączenia, ostatnie wystąpienie jest używane w zestawie wartości.

Słowa kluczowe są niewrażliwe na wielkość liter.

W poniższej tabeli wymieniono prawidłowe nazwy wartości w obiekcie ConnectionString.

Nazwa	Domyślny	Opis
Źródło danych -lub- Serwer		Nazwa lub adres sieciowy wystąpienia programu Oracle, z którym ma być nawiązane połączenie.
Zintegrowane zabezpieczenia	"false"	Czy połączenie ma być bezpiecznym połączeniem, czy nie. Rozpoznane wartości to true (zdecydowanie zalecane), false, yesi no.
Hasło		Hasło do logowania się na koncie Oracle. Aby zachować wysoki poziom zabezpieczeń, zdecydowanie zalecamy użycie słowa kluczowego Zintegrowane zabezpieczenia.
Utrwalanie informacji zabezpieczających	"false"	W przypadku ustawienia false opcji lub no (zdecydowanie zalecane) informacje poufne zabezpieczeń, takie jak hasło, nie są zwracane w ramach połączenia, jeśli połączenie jest otwarte lub kiedykolwiek było otwarte State. Zresetowanie parametry połączenia spowoduje zresetowanie wszystkich wartości parametry połączenia, w tym hasła. Rozpoznane wartości to true, false, yesi no.
Unicode	"false"	Określa, czy dostawca danych .NET Framework dla programu Oracle używa wywołań interfejsu API trybu UTF16. To słowo kluczowe jest ignorowane z wyjątkiem używania oprogramowania klienckiego Oracle9i.
Identyfikator użytkownika		Konto logowania Oracle. Aby zachować wysoki poziom zabezpieczeń, zdecydowanie zalecamy użycie słowa kluczowego Zintegrowane zabezpieczenia.

W poniższej tabeli wymieniono prawidłowe nazwy wartości buforowania połączeń w ramach elementu ConnectionString.

Nazwa	Domyślny	Opis
Okres istnienia połączenia	0	Gdy połączenie zostanie zwrócone do puli, jego czas tworzenia jest porównywany z bieżącą godziną, a połączenie jest niszczone, jeśli ten przedział czasu (w sekundach) przekracza wartość określoną przez Connection Lifetime. Jest to przydatne w konfiguracjach klastrowanych, aby wymusić równoważenie obciążenia między uruchomionym serwerem a serwerem właśnie przeniesionym do trybu online. Wartość zero powoduje, że połączenia w puli mają maksymalny limit czasu połączenia.
Zarejestrować	"true"	Gdy true program lub yes, program pooler automatycznie zaciąga połączenie w bieżącym kontekście transakcji wątku tworzenia. Rozpoznane wartości to true, false, yesi no.
Maksymalny rozmiar puli	100	Maksymalna liczba połączeń dozwolonych w puli. Max Pool Size Ustawienie wartości elementu ConnectionString może mieć wpływ na wydajność. Jeśli planujesz utworzyć i aktywnie używać więcej niż 100 połączeń, należy zwiększyć Max Pool Size wartość, która przybliża użycie połączenia ze stałym stanem dla aplikacji.
Minimalny rozmiar puli	0	Minimalna liczba połączeń dozwolonych w puli.
Buforowanie	"true"	Gdy true obiekt lub yes, OracleConnection jest pobierany z odpowiedniej puli lub w razie potrzeby jest tworzony i dodawany do odpowiedniej puli. Rozpoznane wartości to true, false, yesi no.

Podczas ustawiania wartości słowa kluczowego lub buforowania połączeń, które wymagają wartości logicznej, można użyć wartości "yes" zamiast "true" i "no" zamiast "false". Wartości całkowite są reprezentowane jako ciągi.