OracleConnection.ConnectionString Tulajdonság

Definíció

Névtér:

System.Data.OracleClient

Szerelvény:

System.Data.OracleClient.dll

Lekéri vagy beállítja az Oracle-adatbázis megnyitásához használt sztringet.

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

Tulajdonság értéke

String

Az Oracle kapcsolati karakterlánc, amely tartalmazza a kezdeti kapcsolat létrehozásához szükséges beállításokat, például a kiszolgáló nevét. Az alapértelmezett érték egy üres sztring ("").

Attribútumok

SettingsBindableAttribute

Megjegyzések

A ConnectionString beállítás csak akkor állítható be, ha a kapcsolat bezárult.

A ConnectionString tulajdonság használatával csatlakozhat egy adatbázishoz.

A sztringben megadott számos beállítás rendelkezik megfelelő írásvédett tulajdonságokkal (például Data Source=MyServera DataSource tulajdonságnak megfelelő). Ha a kapcsolati karakterlánc be van állítva, az összes tulajdonság frissül, kivéve, ha hibát észlel, ebben az esetben egyik tulajdonság sem frissül. OracleConnectiontulajdonságok csak az alapértelmezett beállításokat vagy a megadott beállításokat ad vissza.ConnectionString

A ConnectionString zárt kapcsolaton való alaphelyzetbe állítása alaphelyzetbe állítja az összes kapcsolati karakterlánc értéket (és a kapcsolódó tulajdonságokat), beleértve a jelszót is.

A kapcsolati karakterlánc a beállítás után azonnal elemezni kell. Ha az elemzés hibákat jelenít meg a szintaxisban, a rendszer futásidejű kivételt hoz létre, például ArgumentException: Más hibák csak akkor találhatók, ha megkísérlik megnyitni a kapcsolatot.

A kapcsolati karakterlánc alapformátuma kulcsszó-érték párok sorozata, pontosvesszővel elválasztva. Az egyenlőségjel (=) összekapcsolja az egyes kulcsszavakat és azok értékét. Pontosvesszőt, egy idézőjelet vagy dupla idézőjelet tartalmazó értékek hozzáadásához az értéket idézőjelek közé kell foglalni. Ha az érték pontosvesszőt és kettős idézőjelet is tartalmaz, az érték egyetlen idézőjelbe is csatolható. Az egyetlen idézőjel akkor is hasznos, ha az érték kettős idézőjellel kezdődik. Ezzel szemben a dupla idézőjel akkor használható, ha az érték egyetlen idézőjellel kezdődik. Ha az érték egy- és két idézőjelet is tartalmaz, az érték beágyazásához használt idézőjelet minden alkalommal meg kell duplázni, amikor az az értéken belül történik.

Ha a sztringértékbe előző vagy záró szóközöket szeretne belefoglalni, az értéket egyetlen vagy dupla idézőjelbe kell foglalni. A rendszer figyelmen kívül hagyja az egész szám, logikai vagy enumerált értékek körüli kezdő vagy záró szóközöket, még akkor is, ha idézőjelek közé van írva. A sztringkonstans kulcsszón vagy értéken belüli szóközök azonban megmaradnak. Az egy- vagy kettős idézőjelek kapcsolati karakterlánc használhatók elválasztójelek használata nélkül, kivéve, ha az idézőjel az érték első vagy utolsó karaktere, például Data Source= my'Server vagy Data Source= my"Server.

Ha egy kulcsszóba vagy értékbe egyenlőségjelet (=) szeretne belefoglalni, azt egy másik egyenlőségjelnek kell megelőznie. Például a hipotetikus kapcsolati karakterlánc

"key==word=value"

a kulcsszó a "key=word", az érték pedig "value".

Ha egy kulcsszó/érték párban egy adott kulcsszó többször fordul elő egy kapcsolati karakterlánc, az utolsó előfordulást használja a rendszer az értékhalmazban.

A kulcsszavak nem érzékenyek a kis- és nagybetűkre.

Az alábbi táblázat a megadott értékek érvényes nevét sorolja fel.ConnectionString

Name	Alapértelmezett	Leírás
Adatforrás -vagy- Server		Annak az Oracle-példánynak a neve vagy hálózati címe, amelyhez csatlakozni szeretne.
Integrált biztonság	'false'	Függetlenül attól, hogy a kapcsolat biztonságos kapcsolat-e, vagy sem. A felismert értékek true (erősen ajánlottak), falseyesés no.
Password		Az Oracle-fiók bejelentkezésének jelszava. A magas szintű biztonság fenntartása érdekében javasoljuk, hogy inkább az Integrált biztonság kulcsszót használja.
Biztonsági adatok megőrzése	'false'	Ha be van false állítva vagy no (erősen ajánlott), a rendszer nem ad vissza biztonsági szempontból érzékeny információkat, például a jelszót a kapcsolat részeként, ha a kapcsolat nyitva van, vagy valaha is megnyitották State. A kapcsolati karakterlánc alaphelyzetbe állítása alaphelyzetbe állítja az összes kapcsolati karakterlánc értéket, beleértve a jelszót is. A felismert értékek a következőktrue: , falseyesés no.
Unicode	'false'	Megadja, hogy az Oracle-hez készült .NET-keretrendszer Data Provider UTF16 módú API-hívásokat használ-e. Ezt a kulcsszót a rendszer figyelmen kívül hagyja, kivéve, ha Oracle9i ügyfélszoftvert használ.
Felhasználói azonosító		Az Oracle bejelentkezési fiókja. A magas szintű biztonság fenntartása érdekében javasoljuk, hogy inkább az Integrált biztonság kulcsszót használja.

Az alábbi táblázat a kapcsolatkészletezési értékek érvényes nevét sorolja fel a ConnectionString.

Name	Alapértelmezett	Leírás
Kapcsolat élettartama	0	Amikor egy kapcsolat visszakerül a készletbe, annak létrehozási idejét összehasonlítjuk az aktuális időponttal, és a kapcsolat megszűnik, ha ez az időtartam (másodpercben) meghaladja a megadott Connection Lifetime értéket. Ez a fürtözött konfigurációkban hasznos a terheléselosztás kényszerítésére egy futó kiszolgáló és egy nemrég online állapotba hozott kiszolgáló között. A nulla érték miatt a készletezett kapcsolatok maximális kapcsolati időtúllépést eredményeznek.
Igénybe	'true'	Amikor true vagy yes, a készletező automatikusan bevonja a kapcsolatot a létrehozási szál aktuális tranzakciós környezetében. A felismert értékek a következőktrue: , falseyesés no.
Készlet maximális mérete	100	A készletben engedélyezett kapcsolatok maximális száma. A beállítás hatással lehet a Max Pool SizeConnectionString teljesítményre. Ha több mint 100 kapcsolatot szeretne létrehozni és aktívan használni, akkor olyan értékre kell növelnie Max Pool Size , amely megközelíti az alkalmazás állandósult kapcsolathasználatát.
Minimális készletméret	0	A készletben engedélyezett kapcsolatok minimális száma.
Erőforrás-csoportosítás	'true'	Amikor true vagy yes, az OracleConnection objektum a megfelelő készletből származik, vagy szükség esetén létrejön, és hozzáadódik a megfelelő készlethez. A felismert értékek a következőktrue: , falseyesés no.

Ha logikai értéket igénylő kulcsszó- vagy kapcsolatkészletezési értékeket állít be, az "igen" értéket használhatja az "igaz" helyett, a "nem" értéket pedig a "false" helyett. Az egész számértékek sztringekként jelennek meg.