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

Připojovací řetězec Oracle, 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

Poznámky

Tuto ConnectionString možnost lze nastavit pouze při zavření připojení.

Vlastnost můžete použít ConnectionString k připojení k databázi.

Mnoho nastavení zadaných v řetězci má odpovídající vlastnosti jen pro čtení (například Data Source=MyServer, které odpovídá DataSource vlastnosti). Při nastavení připojovacího řetězce se všechny tyto vlastnosti aktualizují, pokud se nezjistí chyba, v takovém případě se žádná z vlastností neaktualizuje. OracleConnection vlastnosti vrátí pouze výchozí nastavení nebo tato nastavení zadaná v sadě ConnectionString.

Resetováním ConnectionString u uzavřeného připojení se obnoví všechny hodnoty připojovacího řetězce (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. Další chyby lze najít pouze v případech, kdy se pokusíte otevřít připojení.

Základní formát připojovacího řetězce je řada párů klíčových slov a hodnot oddělených středníky. Symbol rovná se (=) spojuje každé klíčové slovo a jeho hodnotu. Chcete-li zahrnout hodnoty obsahující středník, znak jednoduché uvozovky nebo znak dvojité uvozovky, musí být hodnota uzavřena do dvojitých uvozovek. Pokud hodnota obsahuje středník i znak dvojité uvozovky, 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é uvozovky. Naopak dvojitá uvozovka se dá použít, pokud hodnota začíná jednou uvozovkou. Pokud hodnota obsahuje znaky jednoduché uvozovky i dvojité uvozovky, musí se znak uvozovky použitý k uzavření hodnoty zdvojnásobit při každém výskytu v hodnotě.

Pokud chcete do řetězcové hodnoty zahrnout předchozí nebo koncové mezery, musí být hodnota uzavřena v jednoduchých uvozovkách nebo dvojitých uvozovkách. Všechny úvodní nebo koncové mezery kolem celého čísla, logické hodnoty nebo výčtu se ignorují, i když jsou uzavřené v uvozovkách. Mezery v řetězcovém literálovém klíčovém slově nebo hodnotě se však zachovají. Jednoduché nebo dvojité uvozovky mohou být použity v připojovacím řetězci bez použití oddělovačů, pokud není znak uvozovek prvním nebo posledním znakem v hodnotě, Data Source= my'Server například nebo Data Source= my"Server.

Pokud chcete do klíčového slova nebo hodnoty zahrnout rovnítko (=), musí mu předcházet jiné znaménko rovná se. Například v hypotetické připojovacím řetězci

"key==word=value"

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

Pokud v připojovacím řetězci dojde ke konkrétnímu klíčovému slovu ve dvojici klíčových slov a hodnot více než jednou, použije se poslední výskyt v sadě hodnot.

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

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

název	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'	Ať už se jedná o zabezpečené připojení, nebo ne. Rozpoznané hodnoty jsou true (důrazně doporučeno), 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čeno), informace citlivé na zabezpečení, jako je například heslo, se nevracely jako součást připojení, pokud je připojení otevřené nebo se někdy nachází v otevřeném Stateprostředí . Resetováním připojovacího řetězce se obnoví všechny hodnoty připojovacího řetězce, včetně hesla. Rozpoznané hodnoty jsou true, false, yesa no.
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 hodnot sdružování připojení v rámci tabulky ConnectionString.

název	Výchozí	Description
Životnost připojení	0	Když se připojení vrátí do fondu, jeho čas vytvoření se porovná s aktuálním časem a připojení se ukončí, pokud časové rozpětí (v sekundách) překročí hodnotu určenou Connection Lifetime. To je užitečné v clusterovaných konfiguracích k vynucení vyrovnávání zatížení mezi běžícím serverem a serverem, který jste právě převedli do režimu online. Hodnota nuly způsobí, že připojení ve fondu budou mít maximální časový limit připojení.
Zařazení	"pravda"	Když true nebo yes, pooler automaticky zařadí připojení do aktuálního kontextu transakce vlákna vytvoř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 mít vliv na ConnectionString výkon. Pokud plánujete vytvářet a aktivně používat více než 100 připojení, měli byste zvýšit Max Pool Size hodnotu, která se blíží využití připojení stabilního stavu pro aplikaci.
Minimální velikost fondu	0	Minimální povolený počet připojení ve fondu.
Sdružování	"pravda"	Pokud true nebo yes, OracleConnection objekt je nakreslen z příslušného fondu nebo v případě potřeby je vytvořen a přidán do příslušného fondu. Rozpoznané hodnoty jsou true, false, yesa no.

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