OracleConnection.ConnectionString Egenskap

Definition

Namnområde:
System.Data.OracleClient
Sammansättning:
System.Data.OracleClient.dll

Hämtar eller anger strängen som används för att öppna en Oracle-databas.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public string ConnectionString { get; set; }
public override string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
Public Property ConnectionString As String
Public Overrides Property ConnectionString As String

Egenskapsvärde

String

Oracle-reťazec pripojenia som innehåller inställningar, till exempel servernamnet, som behövs för att upprätta den första anslutningen. Standardvärdet är en tom sträng ("").

Implementeringar

ConnectionString
Attribut
SettingsBindableAttribute

Kommentarer

Kan ConnectionString endast anges när anslutningen stängs.

Du kan använda egenskapen ConnectionString för att ansluta till en databas.

Många av inställningarna som anges i strängen har motsvarande skrivskyddade egenskaper (till exempel Data Source=MyServer, vilket motsvarar DataSource egenskapen). När reťazec pripojenia har angetts uppdateras alla dessa egenskaper, såvida inte ett fel identifieras, i vilket fall ingen av egenskaperna uppdateras. OracleConnection egenskaper returnerar endast standardinställningar eller de inställningar som anges i ConnectionString.

Om du återställer ConnectionString på en stängd anslutning återställs alla reťazec pripojenia värden (och relaterade egenskaper), inklusive lösenordet.

Connection string parsas omedelbart efter att ha angetts. Om parsning visar fel i syntaxen genereras ett körningsfel, till exempel ArgumentException, . Andra fel kan bara hittas när ett försök görs att öppna anslutningen.

Det grundläggande formatet för en reťazec pripojenia är en serie nyckelord/värdepar avgränsade med semikolon. Likhetstecknet (=) ansluter varje nyckelord och dess värde. Om du vill inkludera värden som innehåller ett semikolon, en citattecken eller ett dubbelcitattecken måste värdet omges av dubbla citattecken. Om värdet innehåller både ett semikolon och ett dubbelcitattecken kan värdet omges av enkla citattecken. Det enkla citattecknet är också användbart om värdet börjar med ett dubbelcitattecken. Omvänt kan du använda dubbla citattecken om värdet börjar med ett enda citattecken. Om värdet innehåller både enkla citattecken och dubbla citattecken måste citattecknet som används för att omsluta värdet fördubblas varje gång det inträffar inom värdet.

Om du vill inkludera föregående eller avslutande blanksteg i strängvärdet måste värdet omges av antingen enkla citattecken eller dubbla citattecken. Alla inledande eller avslutande blanksteg runt heltal, booleska eller uppräknade värden ignoreras, även om de omges av citattecken. Blanksteg inom ett strängliteralt nyckelord eller värde bevaras dock. Enkla eller dubbla citattecken kan användas inom en reťazec pripojenia utan att avgränsare används om inte ett citattecken är det första eller sista tecknet i värdet, till exempel Data Source= my'Server eller Data Source= my"Server.

Om du vill inkludera ett likhetstecken (=) i ett nyckelord eller värde måste det föregås av ett annat likhetstecken. Till exempel i den hypotetiska reťazec pripojenia

"key==word=value"

nyckelordet är "key=word" och värdet är "value".

Om ett specifikt nyckelord i ett nyckelord/värde-par inträffar mer än en gång i en reťazec pripojenia används den sista förekomsten i värdeuppsättningen.

Nyckelord är skiftlägesokänsliga.

I följande tabell visas giltiga namn för värden i ConnectionString.

Name Standardinställning Description
Datakälla

-eller-

Server		 Namnet eller nätverksadressen för den Oracle-instans som ska anslutas till.
Integrerad säkerhet 'false' Om anslutningen ska vara en säker anslutning eller inte.

Identifierade värden är true (rekommenderas starkt), false, yesoch no.
Lösenord Lösenordet för Oracle-kontologgning på. För att upprätthålla en hög säkerhetsnivå rekommenderar vi starkt att du använder nyckelordet Integrerad säkerhet i stället.
Spara säkerhetsinformation 'false' När den är inställd på false eller no (rekommenderas starkt) returneras inte säkerhetskänslig information som lösenordet som en del av anslutningen om anslutningen är öppen eller någonsin har varit öppen State. Om du återställer reťazec pripojenia återställs alla reťazec pripojenia värden, inklusive lösenordet.

Identifierade värden är true, false, yesoch no.
Unicode 'false' Anger om .NET Framework-Data Provider för Oracle använder API-anrop i UTF16-läge. Det här nyckelordet ignoreras förutom när du använder Oracle9i-klientprogramvara.
Användar-ID Oracle-inloggningskontot. För att upprätthålla en hög säkerhetsnivå rekommenderar vi starkt att du använder nyckelordet Integrerad säkerhet i stället.

I följande tabell visas giltiga namn för anslutningspoolvärden i ConnectionString.

Name Standardinställning Description
Livslängd för anslutning 0 När en anslutning returneras till poolen jämförs dess skapandetid med den aktuella tiden och anslutningen förstörs om tidsintervallet (i sekunder) överskrider det värde som anges av Connection Lifetime. Detta är användbart i klustrade konfigurationer för att tvinga fram belastningsutjämning mellan en server som körs och en server som precis har tagits online.

Ett värde på noll gör att poolanslutningar har maximal tidsgräns för anslutningen.
Värva 'true' När true eller yes, registrerar poolverktyget automatiskt anslutningen i skapandetrådens aktuella transaktionskontext.

Identifierade värden är true, false, yesoch no.
Maximal poolstorlek 100 Det maximala antalet anslutningar som tillåts i poolen. Max Pool Size Att ange värdet för ConnectionString kan påverka prestanda. Om du planerar att skapa och aktivt använda fler än 100 anslutningar bör du öka Max Pool Size till ett värde som approximeras användningen av stadiga anslutningar för programmet.
Minsta poolstorlek 0 Det minsta antalet anslutningar som tillåts i poolen.
Pooling 'true' När true eller yes, OracleConnection hämtas objektet från lämplig pool, eller om det behövs, skapas och läggs till i lämplig pool.

Identifierade värden är true, false, yesoch no.

När du anger nyckelords- eller anslutningspoolvärden som kräver ett booleskt värde kan du använda "ja" i stället för "sant" och "nej" i stället för "false". Heltalsvärden representeras som strängar.

Gäller för