Användning av Connection String-nyckelord med SQL Server Native Client

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Vissa SQL Server Native Client API:er använder anslutningssträngar för att specificera anslutningsattribut. Anslutningssträngar är listor över nyckelord och associerade värden; Varje nyckelord identifierar ett särskilt kopplingsattribut.

För information, se Att använda Connection String Keywords med OLE DB Driver for SQL Server.

Följande avsnitt beskriver nyckelord som kan användas med SQL Server Native Client OLE DB-leverantören, SQL Server Native Client ODBC-drivrutinen och ActiveX Data Objects (ADO) när man använder SQL Server Native Client som dataleverantör.

ODBC Driver reťazec pripojenia-nyckelord

ODBC-applikationer använder anslutningssträngar som parametrar till funktionerna SQLDriverConnect och SQLBrowseConnect .

Anslutningssträngar som används av ODBC har följande syntax:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Attributvärden kan valfritt omslutas med klammer, och det är god praxis att göra det. Detta undviker problem när attributvärden innehåller icke-alfanumeriska tecken. Den första stängande klamren i värdet antas avsluta värdet, så värden kan inte innehålla stängande klammertecken.

Följande tabell beskriver nyckelorden som kan användas med en ODBC-reťazec pripojenia.

SQL Server Native Client ODBC-drivrutinen använder lokalregisterinställningarna för den aktuella användaren. Drivrutinen hedrar inte den aktuella trådens lokalitet om applikationen sätter den efter anslutning, till exempel genom att anropa SetThreadLocale.

Att ändra det regionala beteendet hos en datakälla kan orsaka applikationsfel. En applikation som tolkar datumsträngar och förväntar sig att datumsträngar ska visas enligt definitionen av ODBC kan påverkas negativt av att ändra detta värde.

OLE DB Provider Connection String-nyckelord

Det finns två sätt för OLE DB-program att initiera datakällans objekt:

• IDBInitialize::Initialize

• IDataInitialize::GetDataSource

I det första fallet kan en providersträng användas för att initiera anslutningsegenskaper genom att ange egenskapen DBPROP_INIT_PROVIDERSTRING i egenskapsuppsättningen DBPROPSET_DBINIT. I det andra fallet kan en initieringssträng skickas till IDataInitialize::GetDataSource-metoden för att initiera anslutningsegenskaper. Båda metoderna initierar samma OLE DB-anslutningsegenskaper, men olika uppsättningar nyckelord används. Den uppsättning nyckelord som används av IDataInitialize::GetDataSource är minst beskrivningen av egenskaper i initieringsegenskapsgruppen.

Alla providersträngsinställningar som har en motsvarande OLE DB-egenskap inställd på något standardvärde eller uttryckligen inställt på ett värde, åsidosätter OLE DB-egenskapsvärdet inställningen i providersträngen.

Booleska egenskaper satta i leverantörssträngar via DBPROP_INIT_PROVIDERSTRING värden sätts med värdena "ja" och "nej". Booleska egenskaper som sätts i initialiseringssträngar med IDataInitialize::GetDataSource sätts med värdena "true" och "false".

Applikationer som använder IDataInitialize::GetDataSource kan också använda nyckelorden som används av IDBInitialize::Initialize men endast för egenskaper som inte har något standardvärde. Om ett program använder nyckelordet IDataInitialize::GetDataSource och nyckelordet IDBInitialize::Initialize keyword i initieringssträngen används nyckelordsinställningen IDataInitialize::GetDataSource . Det rekommenderas starkt att applikationer inte använder IDBInitialize::Initialize keywords i IDataInitialize:GetDataSource-anslutningssträngar , eftersom detta beteende kanske inte upprätthålls i framtida versioner.

Om du anger flera instanser av samma providerspecifika egenskap används det första värdet för den första egenskapen.

Anslutningssträngar som används när du använder OLE DB-applikationer med DBPROP_INIT_PROVIDERSTRING och IDBInitialize::Initialize har följande syntax:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Attributvärden kan valfritt omslutas med klammer, och det är god praxis att göra det. Detta undviker problem när attributvärden innehåller icke-alfanumeriska tecken. Den första stängande klamren i värdet antas avsluta värdet, så värden kan inte innehålla stängande klammertecken.

Ett blankstegstecken efter nyckelordet = för en anslutningssträng tolkas som en literal, även om värdet omges av citattecken.

I följande tabell beskrivs de nyckelord som kan användas med DBPROP_INIT_PROVIDERSTRING.

Anslutningssträngar som används av OLE DB-program med IDataInitialize::GetDataSource har följande syntax:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[quote]attribute-value[quote]

attribute-value ::= character-string

attribute-keyword ::= identifier

quote ::= " | '

Egenskapsanvändning måste överensstämma med den syntax som tillåts inom dess område. Till exempel använder WSID klammerparenteser ({}) citattecken och Programnamn använder enkla (') eller dubbla (") citattecken. Endast strängegenskaper kan citeras. Försök att citera ett heltal eller en uppräknad egenskap resulterar i ett felmeddelande "Connection String does not conforms to OLE DB specification".

Attributvärden kan valfritt inkluderas i enkla eller dubbla citattecken, och det är god praxis att göra det. Detta undviker problem när värden innehåller icke-alfanumeriska tecken. Citattecknet som används kan också förekomma i värden, förutsatt att det är dubblerat.

Ett blankstegstecken efter nyckelordet = för en anslutningssträng tolkas som en literal, även om värdet omges av citattecken.

Om en anslutningssträng har fler än en av de egenskaper som anges i följande tabell används värdet för den senaste egenskapen.

I följande tabell beskrivs de nyckelord som kan användas med IDataInitialize::GetDataSource:

Not I reťazec pripojenia sätter egenskapen "Gammalt lösenord" SSPROP_AUTH_OLD_PASSWORD, vilket är det aktuella (möjligen utgångna) lösenordet som inte finns tillgängligt via en leverantörssträngsegenskap.

Nyckelord för Anslutningssträng för ActiveX-dataobjekt (ADO)

ADO-program anger egenskapen ConnectionString för ADODBConnection-objekt eller anger en anslutningssträng som en parameter till open-metoden för ADODBConnection-objekt .

ADO-applikationer kan också använda nyckelorden som används av OLE DB IDBInitialize::Initialize-metoden , men endast för egenskaper som inte har något standardvärde. Om ett program använder både ADO-nyckelorden och IDBInitialize::Initiera nyckelord i initieringssträngen används nyckelordsinställningen ADO. Det rekommenderas starkt att applikationer endast använder ADO reťazec pripojenia-nyckelord.

Anslutningssträngar som används av ADO har följande syntax:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=["]attribute-value["]

attribute-value ::= character-string

attribute-keyword ::= identifier

Attributvärden kan valfritt inkluderas i dubbla citattecken, och det är god praxis att göra det. Detta undviker problem när värden innehåller icke-alfanumeriska tecken. Attributvärden kan inte innehålla dubbla citattecken.

I följande tabell beskrivs nyckelorden som kan användas med en ADO-anslutningssträng:

Se även

Skapa program med den interna SQL Server-klienten