SqlConnection.ConnectionString Eigenschap

Definitie

Naamruimte:: System.Data.SqlClient

Assembly:: System.Data.dll

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 SQL Server-database te openen.

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); };

[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }

public override string ConnectionString { get; set; }

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with 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

Waarde van eigenschap

String

De verbindingsreeks die de naam van de brondatabase bevat en andere parameters die nodig zijn om de eerste verbinding tot stand te brengen. De standaardwaarde is een lege tekenreeks.

Implementeringen

ConnectionString

Kenmerken: DataSysDescriptionAttribute SettingsBindableAttribute

Uitzonderingen

ArgumentException

Er is een ongeldig verbindingsreeks argument opgegeven of er is geen vereist verbindingsreeks argument opgegeven.

Voorbeelden

In het volgende voorbeeld wordt een SqlConnection eigenschap gemaakt en ingesteld ConnectionString voordat u de verbinding opent.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Opmerkingen

De ConnectionString is vergelijkbaar met een OLE DB-verbindingsreeks, maar is niet identiek. In tegenstelling tot OLE DB of ADO is de verbindingsreeks die wordt geretourneerd hetzelfde als de gebruikersset ConnectionString, minus beveiligingsgegevens als de waarde persistente beveiligingsgegevens is ingesteld op false (standaard). De .NET Framework-Data Provider voor SQL Server blijft het wachtwoord niet behouden of retourneert het wachtwoord niet in een verbindingsreeks, tenzij u Persistent-beveiligingsgegevens instelt op true.

U kunt de ConnectionString eigenschap gebruiken om verbinding te maken met een database. In het volgende voorbeeld ziet u een typische verbindingsreeks.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"

Gebruik de nieuwe SqlConnectionStringBuilder om geldige verbindingsreeksen te maken tijdens runtime. Zie Verbindingsreeksbouwers voor meer informatie.

De ConnectionString eigenschap kan alleen worden ingesteld wanneer de verbinding is gesloten. Veel van de verbindingsreeks waarden hebben overeenkomende eigenschappen met het kenmerk Alleen-lezen. Wanneer de verbindingsreeks is ingesteld, worden deze eigenschappen bijgewerkt, behalve wanneer er een fout wordt gedetecteerd. In dit geval worden geen van de eigenschappen bijgewerkt. SqlConnection eigenschappen retourneren alleen de instellingen die zijn opgenomen in de ConnectionString.

Als u verbinding wilt maken met een lokale computer, geeft u '(lokaal)' op voor de server. Als er geen servernaam is opgegeven, wordt geprobeerd om verbinding te maken met het standaardexemplaren op de lokale computer.

Als u de ConnectionString opnieuw instelt op een gesloten verbinding, worden alle verbindingsreeks waarden (en gerelateerde eigenschappen) met inbegrip van het wachtwoord opnieuw ingesteld. Als u bijvoorbeeld een verbindingsreeks met Database= AdventureWorks instelt en vervolgens de verbindingsreeks opnieuw instelt op 'Gegevensbron=myserver;' Integrated Security=true", de eigenschap Database is niet meer ingesteld op AdventureWorks.

De verbindingsreeks wordt direct na het instellen geparseerd. Als er fouten in de syntaxis worden gevonden bij het parseren, wordt er een runtime-uitzondering, zoals ArgumentException, gegenereerd. Andere fouten kunnen alleen worden gevonden wanneer er een poging wordt gedaan om de verbinding te openen.

De basisindeling van een verbindingsreeks bevat 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, één 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. Het enkele aanhalingsteken is ook handig als de waarde begint met een dubbel aanhalingsteken. Omgekeerd kan het 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 worden geplaatst. Voorloop- of volgspaties rond gehele getallen, Booleaanse waarden of opsommingswaarden 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 (bijvoorbeeld Gegevensbron= my'Server of Gegevensbron= mijn"Server), tenzij een aanhalingsteken het eerste of laatste teken in de waarde is.

Trefwoorden zijn niet hoofdlettergevoelig.

De volgende tabel bevat de geldige namen voor trefwoordwaarden in de ConnectionStringtabel.

Keyword	Default	Description
`Addr`	N/A	Synoniem van gegevensbron.
`Address`	N/A	Synoniem van gegevensbron.
`App`	N/A	Synoniem van toepassingsnaam.
`Application Name`	N/A	De naam van de toepassing of .NET SQLClient Data Provider als er geen toepassingsnaam is opgegeven. Een toepassingsnaam kan 128 tekens of minder zijn.
`ApplicationIntent`	`ReadWrite`	Declareert het workloadtype van de toepassing bij het maken van verbinding met een server. Mogelijke waarden zijn `ReadOnly` en `ReadWrite`. Voorbeeld: `ApplicationIntent=ReadOnly` Zie SqlClient-ondersteuning voor hoge beschikbaarheid, herstel na noodgevallenvoor meer informatie over sqlClient-ondersteuning voor AlwaysOn-beschikbaarheidsgroepen.
`Asynchronous Processing` – of – `Async`	'false'	Wanneer `true`, schakelt asynchrone bewerkingsondersteuning in. Herkende waarden zijn`true`, `false`, en `yesno`. Deze eigenschap wordt genegeerd vanaf .NET Framework 4.5. Zie Asynchrone programmering voor meer informatie over sqlClient-ondersteuning voor asynchrone programmering.
`AttachDBFilename` – of – `Extended Properties` – of – `Initial File Name`	N/A	De naam van het primaire databasebestand, inclusief de volledige padnaam van een koppelbare database. AttachDBFilename wordt alleen ondersteund voor primaire gegevensbestanden met een .mdf-extensie. Als de waarde van de attachDBFileName-sleutel is opgegeven in de verbindingsreeks, wordt de database gekoppeld en wordt de standaarddatabase voor de verbinding. Als deze sleutel niet is opgegeven en als de database eerder is gekoppeld, wordt de database niet opnieuw gekoppeld. De eerder gekoppelde database wordt gebruikt als de standaarddatabase voor de verbinding. Als deze sleutel samen met de attachDBFileName-sleutel wordt opgegeven, wordt de waarde van deze sleutel gebruikt als de alias. Als de naam echter al wordt gebruikt in een andere gekoppelde database, mislukt de verbinding. Het pad kan absoluut of relatief zijn met behulp van de DataDirectory-vervangingstekenreeks. Als DataDirectory wordt gebruikt, moet het databasebestand bestaan in een submap van de map die wordt verwezen door de vervangingstekenreeks. Opmerking: Namen van externe servers, HTTP- en UNC-paden worden niet ondersteund. De databasenaam moet worden opgegeven met het trefwoord 'database' (of een van de aliassen) zoals in het volgende: `"AttachDbFileName=\|DataDirectory\|\data\YourDB.mdf;integrated security=true;database=YourDatabase"` Er wordt een fout gegenereerd als er een logboekbestand bestaat in dezelfde map als het gegevensbestand en het trefwoord 'database' wordt gebruikt bij het koppelen van het primaire gegevensbestand. Verwijder in dit geval het logboekbestand. Zodra de database is gekoppeld, wordt er automatisch een nieuw logboekbestand gegenereerd op basis van het fysieke pad.
`Authentication`	N/A	De verificatiemethode die wordt gebruikt voor Connecting to SQL Database by Using Azure Active Directory Authentication. Geldige waarden zijn: Active Directory Geïntegreerd, Active Directory wachtwoord, SQL-wachtwoord.
`Column Encryption Setting`	N/A	Hiermee schakelt u Always Encrypted-functionaliteit voor de verbinding in of uit.
`Connect Timeout` – of – `Connection Timeout` – of – `Timeout`	15	De tijdsduur (in seconden) om te wachten op een verbinding met de server voordat de poging wordt beëindigd en er een fout wordt gegenereerd. Geldige waarden zijn groter dan of gelijk aan 0 en kleiner dan of gelijk aan 2147483647. Wanneer u een verbinding met een Azure SQL Database opent, stelt u de time-out voor de verbinding in op 30 seconden.
`Connection Lifetime` – of – `Load Balance Timeout`	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 (0) zorgt ervoor dat gegroepeerde verbindingen de maximale time-out voor de verbinding hebben.
`ConnectRetryCount`	1	Hiermee bepaalt u het aantal pogingen om opnieuw verbinding te maken nadat de client een niet-actieve verbindingsfout identificeert. Geldige waarden zijn 0 tot 255. De standaardwaarde is één. 0 betekent dat u geen opnieuw verbinding probeert te maken (verbindingstolerantie uitschakelen). Zie .NET SqlConnection-parameters voor opnieuw proberen en Technisch artikel- Niet-actieve verbindingstolerantie voor meer informatie over verbindingstolerantie.
`ConnectRetryInterval`	10	Hiermee geeft u de tijd tussen elke poging tot opnieuw proberen van de verbinding (ConnectRetryCount). Geldige waarden zijn 1 tot 60 seconden (standaard=10), toegepast na de eerste poging om opnieuw verbinding te maken. Wanneer er een verbroken verbinding wordt gedetecteerd, probeert de client onmiddellijk opnieuw verbinding te maken; dit is de eerste poging om opnieuw verbinding te maken en vindt alleen plaats als ConnectRetryCount groter is dan 0. Als de eerste poging om opnieuw verbinding te maken mislukt en ConnectRetryCount groter is dan 1, wacht de client op ConnectRetryInterval om de tweede en volgende pogingen om opnieuw verbinding te maken. Zie .NET SqlConnection-parameters voor opnieuw proberen en Technisch artikel- Niet-actieve verbindingstolerantie voor meer informatie over verbindingstolerantie.
`Context Connection`	'false'	`true` als er een in-process verbinding met SQL Server moet worden gemaakt.
`Current Language` – of – `Language`	N/A	Hiermee stelt u de taal in die wordt gebruikt voor waarschuwing of foutberichten van de databaseserver. De taalnaam kan 128 tekens of minder zijn.
`Data Source` – of – `Server` – of – `Address` – of – `Addr` – of – `Network Address`	N/A	De naam of het netwerkadres van het exemplaar van SQL Server waarmee verbinding moet worden gemaakt. Het poortnummer kan worden opgegeven na de servernaam: `server=tcp:servername, portnumber` Wanneer u een lokaal exemplaar opgeeft, gebruikt u altijd (lokaal). Als u een protocol wilt afdwingen, voegt u een van de volgende voorvoegsels toe: `np:(local), tcp:(local), lpc:(local)` Vanaf .NET Framework 4.5 kunt u als volgt verbinding maken met een LocalDB-database: `server=(localdb)\\myInstance` Zie SqlClient-ondersteuning voor LocalDB voor meer informatie over LocalDB. De gegevensbron moet de TCP-indeling of de indeling Named Pipes gebruiken. TCP-indeling is als volgt: - tcp:<host name>\<instance name> - tcp:<hostnaam>,< TCP/IP-poortnummer> De TCP-indeling moet beginnen met het voorvoegsel TCP:en wordt gevolgd door het database-exemplaar, zoals opgegeven door een hostnaam en een exemplaarnaam. Deze indeling is niet van toepassing wanneer u verbinding maakt met Azure SQL Database. TCP wordt automatisch geselecteerd voor verbindingen met Azure SQL Database wanneer er geen protocol is opgegeven. De hostnaam moet op een van de volgende manieren worden opgegeven: - NetBIOSName - IPv4Address - IPv6Address De naam van het exemplaar wordt gebruikt om een bepaald TCP/IP-poortnummer op te lossen waarop een database-exemplaar wordt gehost. U kunt ook rechtstreeks een TCP/IP-poortnummer opgeven. Als zowel de naam van het exemplaar als het poortnummer niet aanwezig zijn, wordt het standaarddatabase-exemplaar gebruikt. De indeling Named Pipes is als volgt: - np:\\<host name>\pipe\pipe\<pipe name> De indeling Named Pipes MOET beginnen met het voorvoegsel "np:" en wordt gevolgd door een benoemde pijpnaam. De hostnaam moet op een van de volgende manieren worden opgegeven: - NetBIOSName - IPv4Address - IPv6Address De pijpnaam wordt gebruikt om het database-exemplaar te identificeren waarmee de .NET Framework-toepassing wordt verbonden. Als de waarde van de netwerksleutel is opgegeven, mogen de voorvoegsels 'tcp:' en 'np:' niet worden opgegeven. Note: U kunt het gebruik van TCP afdwingen in plaats van gedeeld geheugen door het voorvoegsel tcp: naar de servernaam in de verbindingsreeks of door localhost te gebruiken.
`Encrypt`	'false'	Wanneer `true`, gebruikt SQL Server SSL-versleuteling voor alle gegevens die worden verzonden tussen de client en de server als er een certificaat is geïnstalleerd op de server. Herkende waarden zijn`true`, `false`, en `yesno`. Zie De syntaxis van de verbindingsreeks voor meer informatie. Vanaf .NET Framework 4.5 moet de servernaam (of het IP-adres) in een SQL Server SSL-certificaat exact overeenkomen met de servernaam (of het IP-adres) die is opgegeven in de verbindingsreeks, wanneer `TrustServerCertificate` onwaar is en `Encrypt` waar is. Anders mislukt de verbindingspoging.
`Enlist`	'true'	`true` geeft aan dat de SQL Server verbindingspooler automatisch de verbinding in de huidige transactiecontext van de aanmaakthread inschrijft.
`Failover Partner`	N/A	De naam van de failoverpartnerserver waar databasespiegeling is geconfigureerd. Als de waarde van deze sleutel '' is, moet de oorspronkelijke catalogus aanwezig zijn en mag de waarde niet '' zijn. De servernaam mag maximaal 128 tekens bevatten. Als u een failoverpartner opgeeft, maar de failoverpartnerserver niet is geconfigureerd voor databasespiegeling en de primaire server (opgegeven met het trefwoord Server) niet beschikbaar is, mislukt de verbinding. Als u een failoverpartner opgeeft en de primaire server niet is geconfigureerd voor databasespiegeling, slaagt de verbinding met de primaire server (opgegeven met het trefwoord Server) als de primaire server beschikbaar is.
`Initial Catalog` – of – `Database`	N/A	De naam van de database. De databasenaam mag maximaal 128 tekens bevatten.
`Integrated Security` – of – `Trusted_Connection`	'false'	Wanneer `false`, gebruikers-id en wachtwoord worden opgegeven in de verbinding. Wanneer `true`, worden de huidige Windows-accountreferenties gebruikt voor verificatie. Herkende waarden zijn , , , `yes`, en `sspino`(sterk aanbevolen), wat gelijk is aan `true`. `falsetrue` Als de gebruikers-id en het wachtwoord zijn opgegeven en geïntegreerde beveiliging is ingesteld op true, worden de gebruikers-id en het wachtwoord genegeerd en wordt geïntegreerde beveiliging gebruikt. SqlCredential is een veiligere manier om referenties op te geven voor een verbinding die gebruikmaakt van SQL Server-verificatie (`Integrated Security=false`).
`Max Pool Size`	100	Het maximum aantal verbindingen dat is toegestaan in de groep. Geldige waarden zijn groter dan of gelijk aan 1. Waarden die kleiner zijn dan minimale poolgrootte genereren een fout.
`Min Pool Size`	0	Het minimale aantal verbindingen dat is toegestaan in de groep. Geldige waarden zijn groter dan of gelijk aan 0. Nul (0) in dit veld betekent dat er in eerste instantie geen minimale verbindingen worden geopend. Waarden die groter zijn dan de maximale poolgrootte , genereren een fout.
`MultipleActiveResultSets`	'false'	Wanneer `true`kan een toepassing meerdere actieve resultatensets (MARS) onderhouden. Wanneer `false`, moet een toepassing alle resultatensets van de ene batch verwerken of annuleren voordat deze een andere batch op die verbinding kan uitvoeren. Herkende waarden zijn `true` en `false`. Zie Meerdere actieve resultatensets (MARS) voor meer informatie.
`MultiSubnetFailover`	FALSE	Geef altijd `multiSubnetFailover=True` op wanneer u verbinding maakt met de listener van een beschikbaarheidsgroep van SQL Server 2012 (of hoger) of een SQL Server 2012-failoverclusterexemplaren (of hoger). `multiSubnetFailover=True` configureert SqlClient om snellere detectie van en verbinding met de (momenteel) actieve server te bieden. Mogelijke waarden zijn `Yes` en`No`, `True` en `False` of en`01`. Voorbeeld: `MultiSubnetFailover=True` De standaardwaarde is `False`. Zie SqlClient-ondersteuning voor hoge beschikbaarheid, herstel na noodgevallen voor meer informatie over de ondersteuning van SqlClient voor AlwaysOn AGs.
`Network Library` – of – `Network` – of – `Net`	N/A	De netwerkbibliotheek die wordt gebruikt om een verbinding tot stand te brengen met een exemplaar van SQL Server. Ondersteunde waarden zijn onder andere: dbnmpntw (Named Pipes) dbmsrpcn (Multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (gedeeld geheugen) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) De bijbehorende netwerk-DLL moet worden geïnstalleerd op het systeem waarmee u verbinding maakt. Als u geen netwerk opgeeft en u een lokale server gebruikt (bijvoorbeeld '.' of '(lokaal)'), wordt gedeeld geheugen gebruikt. In dit voorbeeld is de netwerkbibliotheek Win32 Winsock TCP/IP (dbmssocn) en 1433 de poort die wordt gebruikt. `Network Library=dbmssocn;Data Source=000.000.000.000,1433;`
`Packet Size`	achtduizend	Grootte in bytes van de netwerkpakketten die worden gebruikt om te communiceren met een exemplaar van SQL Server. De pakketgrootte kan groter zijn dan of gelijk zijn aan 512 en kleiner dan of gelijk aan 32768.
`Password` – of – `PWD`	N/A	Het wachtwoord voor de SQL Server-accountregistratie is ingeschakeld. Niet aanbevolen. Als u een hoog beveiligingsniveau wilt behouden, raden we u ten zeerste aan in plaats daarvan het `Integrated Security` of `Trusted_Connection` trefwoord te gebruiken. SqlCredential is een veiligere manier om referenties op te geven voor een verbinding die gebruikmaakt van SQL Server-verificatie. Het wachtwoord moet 128 tekens of minder zijn.
`Persist Security Info` – of – `PersistSecurityInfo`	'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 open staat is geweest. Als u de verbindingsreeks opnieuw instelt, worden alle verbindingsreeks waarden, inclusief het wachtwoord, opnieuw ingesteld. Herkende waarden zijn`true`, `false`, en `yesno`.
`PoolBlockingPeriod`	Auto	Hiermee stelt u het gedrag van de blokkeringsperiode voor een verbindingsgroep in. Zie PoolBlockingPeriod de eigenschap voor meer informatie.
`Pooling`	'true'	Wanneer de waarde van deze sleutel is ingesteld op true, wordt elke zojuist gemaakte verbinding toegevoegd aan de groep wanneer deze door de toepassing wordt gesloten. In een volgende poging om dezelfde verbinding te openen, wordt die verbinding uit de pool getrokken. Verbindingen worden als hetzelfde beschouwd als ze dezelfde verbindingsreeks hebben. Verschillende verbindingen hebben verschillende verbindingsreeksen. De waarde van deze sleutel kan 'true', 'false', 'yes' of 'nee' zijn.
`Replication`	'false'	`true` als replicatie wordt ondersteund met behulp van de verbinding.
`Transaction Binding`	Impliciete ontkoppeling	Hiermee bepaalt u de koppeling van de verbinding met een in de lijst vermelde `System.Transactions` transactie. Mogelijke waarden zijn: `Transaction Binding=Implicit Unbind;` `Transaction Binding=Explicit Unbind;` Impliciete binding zorgt ervoor dat de verbinding loskoppelt van de transactie wanneer deze eindigt. Na het loskoppelen worden extra aanvragen voor de verbinding uitgevoerd in de modus Automatisch aanpassen. De `System.Transactions.Transaction.Current` eigenschap wordt niet gecontroleerd bij het uitvoeren van aanvragen terwijl de transactie actief is. Nadat de transactie is beëindigd, worden extra aanvragen uitgevoerd in de modus Voor automatisch aanpassen. Als het systeem de transactie beëindigt (binnen het bereik van een using-blok) voordat de laatste opdracht is voltooid, wordt deze gegooid InvalidOperationException. Expliciet ontkoppelen zorgt ervoor dat de verbinding gekoppeld blijft aan de transactie totdat de verbinding wordt gesloten of een expliciete `SqlConnection.TransactionEnlist(null)` aangeroepen verbinding wordt aangeroepen. Vanaf .NET Framework 4 zijn wijzigingen in impliciete niet-gekoppelde inhoud verouderd. Er `InvalidOperationException` wordt een gegenereerd als `Transaction.Current` dit niet de in de lijst opgenomen transactie is of als de in de lijst opgenomen transactie niet actief is.
`TransparentNetworkIPResolution`	Zie beschrijving.	Wanneer de waarde van deze sleutel is ingesteld `true`op, is de toepassing vereist om alle IP-adressen voor een bepaalde DNS-vermelding op te halen en verbinding te maken met de eerste in de lijst. Als de verbinding niet binnen 0,5 seconden tot stand is gebracht, probeert de toepassing parallel verbinding te maken met alle andere. Wanneer de eerste antwoorden worden beantwoord, wordt de verbinding met het IP-adres van de respondent tot stand gebracht. Als de `MultiSubnetFailover` sleutel is ingesteld op `true`, `TransparentNetworkIPResolution` wordt genegeerd. Als de `Failover Partner` sleutel is ingesteld, `TransparentNetworkIPResolution` wordt deze genegeerd. De waarde van deze sleutel moet zijn `true`, `false`, `yes`of `no`. Een waarde van `yes` wordt hetzelfde behandeld als een waarde van `true`. Een waarde van `no` wordt hetzelfde behandeld als een waarde van `false`. De standaardwaarden zijn zoals hieronder weergegeven: `false` Wanneer: Verbinding maken met Azure SQL Database waar de gegevensbron eindigt op: .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net `Authentication` is 'Active Directory wachtwoord' of 'Active Directory geïntegreerd' `true` in alle andere gevallen.
`TrustServerCertificate`	'false'	Wanneer deze instelling is ingesteld `true`, wordt SSL gebruikt om het kanaal te versleutelen bij het omzeilen van de certificaatketen om de vertrouwensrelatie te valideren. Als TrustServerCertificate is ingesteld op `true` en Encrypt is ingesteld `false`op, wordt het kanaal niet versleuteld. Herkende waarden zijn`true`, `false`, en `yesno`. Zie De syntaxis van de verbindingsreeks voor meer informatie.
`Type System Version`	N/A	Een tekenreekswaarde die aangeeft welk type systeem de toepassing verwacht. De functionaliteit die beschikbaar is voor een clienttoepassing is afhankelijk van de versie van SQL Server en het compatibiliteitsniveau van de database. Het expliciet instellen van de typesysteemversie die door de clienttoepassing is geschreven om potentiële problemen te voorkomen die ertoe kunnen leiden dat een toepassing wordt onderbroken als een andere versie van SQL Server wordt gebruikt. Note: Kan de systeemversie van het type niet instellen voor CLR-code (Common Language Runtime) die in SQL Server wordt uitgevoerd. Zie SQL Server Common Language Runtime Integration voor meer informatie. Mogelijke waarden zijn: `Type System Version=SQL Server 2012;` `Type System Version=SQL Server 2008;` `Type System Version=SQL Server 2005;` `Type System Version=Latest;` `Type System Version=SQL Server 2012;` geeft aan dat de toepassing versie 11.0.0.0 van Microsoft.SqlServer.Types.dllvereist. Voor de andere `Type System Version`-instellingen is versie 10.0.0.0 van Microsoft.SqlServer.Types.dllvereist. `Latest` is verouderd en mag niet worden gebruikt. `Latest` is gelijk aan `Type System Version=SQL Server 2008;`.
`User ID` – of – `UID` – of – `User`	N/A	Het SQL Server aanmeldingsaccount. Niet aanbevolen. Als u een hoog beveiligingsniveau wilt behouden, raden we u ten zeerste aan de `Integrated Security` trefwoorden of `Trusted_Connection` trefwoorden te gebruiken. SqlCredential is een veiligere manier om referenties op te geven voor een verbinding die gebruikmaakt van SQL Server-verificatie. De gebruikers-id moet 128 tekens of minder zijn.
`User Instance`	'false'	Een waarde die aangeeft of de verbinding moet worden omgeleid van de standaard-SQL Server Express-exemplaar naar een door runtime geïnitieerd exemplaar dat wordt uitgevoerd onder het account van de aanroeper.
`Workstation ID` – of – `WSID`	De naam van de lokale computer	De naam van het werkstation dat verbinding maakt met SQL Server. De id moet 128 tekens of minder zijn.

De volgende lijst bevat de geldige namen voor verbindingspoolwaarden in de ConnectionString. Zie SQL Server Connection Pooling (ADO.NET) voor meer informatie.

Connection Lifetime (of Load Balance Timeout)
Enlist
Max Pool Size
Min Pool Size
Pooling

Wanneer u waarden voor trefwoorden of verbindingspools instelt waarvoor een Booleaanse waarde is vereist, kunt yes u in plaats van true, en no in plaats van false. Gehele getallen worden weergegeven als tekenreeksen.

Note

De .NET Framework-Data Provider voor SQL Server maakt gebruik van een eigen protocol om te communiceren met SQL Server. Daarom wordt het gebruik van een ODBC-gegevensbronnaam (DSN) niet ondersteund bij het maken van verbinding met SQL Server omdat er geen ODBC-laag wordt toegevoegd.

Note

UDL-bestanden (Universal Data Link) worden niet ondersteund voor de .NET Framework-Data Provider voor SQL Server.

Waarschuwing

Wees voorzichtig bij het samenstellen van een verbindingsreeks op basis van gebruikersinvoer (bijvoorbeeld bij het ophalen van gebruikers-id's en wachtwoordgegevens uit een dialoogvenster en het toevoegen aan de verbindingsreeks). Zorg ervoor dat een gebruiker geen extra verbindingsreeks parameters in deze waarden kan insluiten (bijvoorbeeld het invoeren van een wachtwoord als 'validpassword; database=somedb" in een poging om te koppelen aan een andere database). Als u verbindingsreeksen wilt maken op basis van gebruikersinvoer, gebruikt u SqlConnectionStringBuilder, waarmee de verbindingsreeks worden gevalideerd en dit probleem wordt voorkomen. Zie Verbindingsreeksbouwers voor meer informatie.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?