OracleConnection.ConnectionString Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de tekenreeks op die wordt gebruikt om een Oracle-database te openen of stelt u deze in.
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, setPublic Property ConnectionString As StringPublic Overrides Property ConnectionString As StringWaarde van eigenschap
De Oracle-verbindingsreeks die instellingen bevat, zoals de servernaam, die nodig is om de eerste verbinding tot stand te brengen. De standaardwaarde is een lege tekenreeks ("").
Implementeringen
- Kenmerken
Opmerkingen
De ConnectionString kan alleen worden ingesteld wanneer de verbinding is gesloten.
U kunt de ConnectionString eigenschap gebruiken om verbinding te maken met een database.
Veel van de instellingen die in de tekenreeks zijn opgegeven, hebben bijbehorende alleen-lezeneigenschappen (bijvoorbeeld, Data Source=MyServerdie overeenkomt met de DataSource eigenschap). Wanneer de verbindingsreeks is ingesteld, worden al deze eigenschappen bijgewerkt, tenzij er een fout wordt gedetecteerd. In dat geval worden geen van de eigenschappen bijgewerkt.
OracleConnection eigenschappen retourneren alleen standaardinstellingen of die instellingen die zijn opgegeven in de ConnectionString.
Als u de ConnectionString opnieuw instelt op een gesloten verbinding, worden alle verbindingsreeks waarden (en gerelateerde eigenschappen) opnieuw ingesteld, inclusief het wachtwoord.
De verbindingsreeks wordt direct na het instellen geparseerd. Als bij het parseren fouten in de syntaxis worden weergegeven, wordt er een runtime-uitzondering gegenereerd, zoals ArgumentException. Andere fouten kunnen alleen worden gevonden wanneer er een poging wordt gedaan om de verbinding te openen.
De basisindeling van een verbindingsreeks is een reeks trefwoord-/waardeparen, gescheiden door puntkomma's. Het gelijkteken (=) verbindt elk trefwoord en de bijbehorende waarde. Als u waarden wilt opnemen die een puntkomma, een enkel aanhalingsteken of dubbel aanhalingsteken bevatten, moet de waarde tussen dubbele aanhalingstekens worden geplaatst. Als de waarde zowel een puntkomma als een dubbel aanhalingsteken bevat, kan de waarde tussen enkele aanhalingstekens worden geplaatst. De enkele aanhalingstekens zijn ook handig als de waarde begint met een dubbel aanhalingsteken. Omgekeerd kan de dubbele aanhalingsteken worden gebruikt als de waarde begint met één aanhalingsteken. Als de waarde zowel enkele aanhalingstekens als dubbele aanhalingstekens bevat, moet het aanhalingsteken dat wordt gebruikt om de waarde in te sluiten, worden verdubbeld telkens wanneer deze binnen de waarde voorkomt.
Als u voorafgaande of volgspaties in de tekenreekswaarde wilt opnemen, moet de waarde tussen enkele aanhalingstekens of dubbele aanhalingstekens staan. Voorloop- of volgspaties rond gehele getallen, Booleaanse waarden of opgesomde waarden worden genegeerd, zelfs als deze tussen aanhalingstekens staan. Spaties binnen een letterlijk trefwoord of een letterlijke tekenreekswaarde blijven echter behouden. Enkele of dubbele aanhalingstekens kunnen worden gebruikt binnen een verbindingsreeks zonder scheidingstekens te gebruiken, tenzij een aanhalingsteken het eerste of laatste teken in de waarde is, bijvoorbeeld Data Source= my'Server of Data Source= my"Server.
Als u een gelijkteken (=) wilt opnemen in een trefwoord of waarde, moet dit worden voorafgegaan door een ander gelijkteken. Bijvoorbeeld in de hypothetische verbindingsreeks
"key==word=value"
het trefwoord is "key=word" en de waarde is "value".
Als een specifiek trefwoord in een trefwoord/waardepaar meerdere keren voorkomt in een verbindingsreeks, wordt het laatste exemplaar gebruikt in de waardeset.
Trefwoorden zijn niet hoofdlettergevoelig.
De volgende tabel bevat de geldige namen voor waarden in de ConnectionStringtabel.
| Naam | Default | Description |
|---|---|---|
| Gegevensbron – of – Server |
De naam of het netwerkadres van het exemplaar van Oracle waarmee verbinding moet worden gemaakt. | |
| Geïntegreerde beveiliging | 'false' | Of de verbinding nu een beveiligde verbinding moet zijn of niet. Herkende waarden worden true (sterk aanbevolen), falseen yesno. |
| Password | Het wachtwoord voor het aanmelden bij het Oracle-account. Als u een hoog beveiligingsniveau wilt behouden, raden we u ten zeerste aan in plaats daarvan het trefwoord Geïntegreerde beveiliging te gebruiken. | |
| Beveiligingsgegevens behouden | 'false' | Als deze optie is ingesteld op false of no (sterk aanbevolen), wordt beveiligingsgevoelige informatie, zoals het wachtwoord, niet geretourneerd als onderdeel van de verbinding als de verbinding is geopend of ooit in een geopend Statebestand is geweest. Als u de verbindingsreeks opnieuw instelt, worden alle verbindingsreeks waarden, inclusief het wachtwoord, opnieuw ingesteld.Herkende waarden zijn true, false, en yesno. |
| Unicode | 'false' | Hiermee geeft u op of de .NET Framework-Data Provider voor Oracle gebruikmaakt van API-aanroepen in de modus UTF16. Dit trefwoord wordt genegeerd, behalve wanneer u Oracle9i-clientsoftware gebruikt. |
| Gebruikers-ID | Het Oracle-aanmeldingsaccount. Als u een hoog beveiligingsniveau wilt behouden, raden we u ten zeerste aan in plaats daarvan het trefwoord Geïntegreerde beveiliging te gebruiken. |
De volgende tabel bevat de geldige namen voor verbindingsgroepwaarden binnen de ConnectionString.
| Naam | Default | Description |
|---|---|---|
| Levensduur van verbinding | 0 | Wanneer een verbinding wordt geretourneerd naar de pool, wordt de aanmaaktijd vergeleken met de huidige tijd en wordt de verbinding vernietigd als die tijdsduur (in seconden) de waarde overschrijdt die is opgegeven door Connection Lifetime. Dit is handig in geclusterde configuraties om taakverdeling af te dwingen tussen een actieve server en een server die zojuist online is gebracht.Een waarde van nul zorgt ervoor dat gegroepeerde verbindingen de maximale time-out voor de verbinding hebben. |
| Aanmeldlijst | 'true' | Wanneer true of yes, schakelt de pooler automatisch de verbinding in de huidige transactiecontext van de creatiethread in.Herkende waarden zijn true, false, en yesno. |
| Maximale poolgrootte | 100 | Het maximum aantal verbindingen dat is toegestaan in de pool. Het instellen van de Max Pool Size waarde van de ConnectionString waarde kan van invloed zijn op de prestaties. Als u van plan bent om meer dan 100 verbindingen te maken en actief te gebruiken, moet u de waarde verhogen Max Pool Size tot een waarde die het gebruik van een stabiele verbinding voor de toepassing bij benadering benadert. |
| Minimale poolgrootte | 0 | Het minimale aantal verbindingen dat is toegestaan in de groep. |
| Samenvoegen | 'true' | Wanneer true of yes, wordt het OracleConnection object uit de juiste groep gehaald, of indien nodig, gemaakt en toegevoegd aan de juiste groep.Herkende waarden zijn true, false, en yesno. |
Wanneer u waarden voor trefwoorden of verbindingsgroepen instelt waarvoor een Booleaanse waarde is vereist, kunt u ja gebruiken in plaats van 'true' en 'nee' in plaats van 'false'. Gehele getallen worden weergegeven als tekenreeksen.