OracleConnection.ConnectionString Vlastnost

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

Získá nebo nastaví řetězec použitý k otevření databáze 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

Hodnota vlastnosti

String

Oracle připojovací řetězec, který obsahuje nastavení, jako je název serveru, potřebný k navázání počátečního připojení. Výchozí hodnota je prázdný řetězec ("").

Atributy

SettingsBindableAttribute

Příklady

Následující příklad vytvoří OracleConnection a nastaví některé jeho vlastnosti v připojovací řetězec.

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

Poznámky

Parametr ConnectionString lze nastavit pouze v případech, kdy je připojení ukončeno.

Vlastnost můžete použít ConnectionString pro připojení k databázi. Následující příklad znázorňuje typický připojovací řetězec.

"Data Source=Oracle8i;Integrated Security=yes"  

Mnoho nastavení zadaných v řetězci má odpovídající vlastnosti jen pro čtení (například Data Source=MyServer, které odpovídají DataSource vlastnosti ). Pokud je nastavena připojovací řetězec, všechny tyto vlastnosti se aktualizují, pokud se nezjistí chyba. V takovém případě se neaktualizují žádné vlastnosti. OracleConnection Vlastnosti vrátí pouze výchozí nastavení nebo nastavení zadaná v ConnectionString.

Resetováním ConnectionString u uzavřeného připojení se resetují všechny připojovací řetězec hodnoty (a související vlastnosti), včetně hesla.

Připojovací řetězec se parsuje okamžitě po nastavení. Pokud analýza odhalí chyby v syntaxi, vygeneruje se výjimka za běhu, například ArgumentException. Jiné chyby se dají najít jenom v případech, kdy dojde k pokusu o otevření připojení.

Základní formát připojovací řetězec je řada párů klíčového slova a hodnoty oddělených středníky. Znaménko rovná se (=) spojuje každé klíčové slovo a jeho hodnotu. Chcete-li zahrnout hodnoty, které obsahují středník, znak jednoduchých uvozovek nebo znak dvojité uvozovky, musí být hodnota uzavřena do dvojitých uvozovek. Pokud hodnota obsahuje středník i znak dvojitých uvozovek, může být hodnota uzavřena v jednoduchých uvozovkách. Jednoduchá uvozovka je užitečná také v případě, že hodnota začíná znakem dvojitých uvozovek. Naopak dvojitou uvozovku lze použít, pokud hodnota začíná jednoduchou uvozovkou. Pokud hodnota obsahuje znaky jednoduchých i dvojitých uvozovek, znak uvozovek použitý k uzavření hodnoty se musí při každém výskytu v rámci hodnoty zdvojnásobit.

Chcete-li do řetězcové hodnoty zahrnout předchozí nebo koncové mezery, musí být hodnota uzavřena v jednoduchých nebo dvojitých uvozovkách. Všechny počáteční nebo koncové mezery kolem celočíselné, logické nebo výčtové hodnoty jsou ignorovány, a to i v případě, že jsou uzavřeny v uvozovkách. Mezery v klíčovém slově nebo hodnotě řetězcového literálu jsou však zachovány. Jednoduché nebo dvojité uvozovky lze použít v rámci připojovací řetězec bez použití oddělovačů, pokud znak uvozovek není prvním nebo posledním znakem v hodnotě, Data Source= my'Server například nebo Data Source= my"Server.

Chcete-li v klíčovém slově nebo hodnotě zahrnout rovnítko (=), musí předcházet jiné znaménko rovná se. Například v hypotetické připojovací řetězec

"key==word=value"  

klíčové slovo je "key=word" a hodnota je "value".

Pokud se určité klíčové slovo ve dvojici klíčového slova a hodnoty vyskytuje více než jednou v připojovací řetězec, použije se poslední výskyt v sadě hodnot.

Klíčová slova nerozlišují malá a velká písmena.

Následující tabulka uvádí platné názvy hodnot v rámci ConnectionString.

Name	Výchozí	Description
Zdroj dat -nebo- Server		Název nebo síťová adresa instance Oracle, ke které se chcete připojit.
Integrované zabezpečení	"false"	Určuje, jestli má být připojení zabezpečené nebo ne. Rozpoznané hodnoty jsou true (důrazně doporučujeme), false, yesa no.
Heslo		Heslo pro přihlášení účtu Oracle. Pokud chcete zachovat vysokou úroveň zabezpečení, důrazně doporučujeme místo toho použít klíčové slovo Integrované zabezpečení.
Zachování bezpečnostních údajů	"false"	Pokud je nastavená hodnota false nebo no (důrazně doporučujeme), informace citlivé na zabezpečení, jako je například heslo, se nevrátí jako součást připojení, pokud je připojení otevřené nebo bylo v otevřené Stateslužbě . Resetováním připojovací řetězec se resetují všechny připojovací řetězec hodnoty, včetně hesla. Rozpoznané hodnoty jsou true, false, yesa no.
Kódování Unicode	"false"	Určuje, jestli zprostředkovatel dat rozhraní .NET Framework pro Oracle používá volání rozhraní API režimu UTF16. Toto klíčové slovo je ignorováno s výjimkou použití klientského softwaru Oracle9i.
ID uživatele		Přihlašovací účet Oracle. Pokud chcete zachovat vysokou úroveň zabezpečení, důrazně doporučujeme místo toho použít klíčové slovo Integrované zabezpečení.

Následující tabulka uvádí platné názvy pro hodnoty sdružování připojení v rámci .ConnectionString

Name	Výchozí	Description
Doba života připojení	0	Když se připojení vrátí do fondu, porovná se čas jeho vytvoření s aktuálním časem a připojení se zničí, pokud tento časový rozsah (v sekundách) překročí hodnotu určenou parametrem Connection Lifetime. To je užitečné v clusterovaných konfiguracích k vynucení vyrovnávání zatížení mezi spuštěným serverem a serverem, který byl právě online. Hodnota nula způsobí, že u připojení ve fondu vyprší maximální časový limit připojení.
Zařazení	True	Když true nebo yes, nástroj pro sdružování automaticky zařadí připojení do aktuálního kontextu transakce vlákna vytváření. Rozpoznané hodnoty jsou true, false, yesa no.
Maximální velikost fondu	100	Maximální počet připojení povolených ve fondu Max Pool Size Nastavení hodnoty může ConnectionString ovlivnit výkon. Pokud plánujete vytvořit a aktivně používat více než 100 připojení, měli byste zvýšit Max Pool Size hodnotu na hodnotu, která odpovídá využití připojení v ustáleném stavu pro aplikaci.
Minimální velikost fondu	0	Minimální povolený počet připojení ve fondu.
Sdružování	True	Když true nebo yes, OracleConnection objekt se vykreslí z příslušného fondu nebo se v případě potřeby vytvoří a přidá do příslušného fondu. Rozpoznané hodnoty jsou true, false, yesa no.

Při nastavování klíčových slov nebo hodnot sdružování připojení, které vyžadují logickou hodnotu, můžete místo true použít ano a ne. Celočíselné hodnoty jsou reprezentovány jako řetězce.