Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Minden ADO.NET adatszolgáltató rendelkezik egy olyan Connection objektummal, amely a ConnectionString elemből öröklődik, valamint egy szolgáltatóspecifikus DbConnection tulajdonsággal. Az egyes szolgáltatók adott kapcsolati sztring szintaxisa ConnectionString a tulajdonságában van dokumentálva. Az alábbi táblázat a Microsoft.Data.SqlClientet és a .NET-keretrendszerben található három szolgáltatót sorolja fel.
| Adatszolgáltató | Leírás |
|---|---|
| Microsoft.Data.SqlClient | Adatelérést biztosít a Microsoft SQL Serverhez a Microsoft.Data.SqlClient NuGet-csomagon keresztül. Az kapcsolati sztring szintaxissal kapcsolatos további információkért lásd: ConnectionString. |
| System.Data.OleDb | Adathozzáférést biztosít az OLE DB használatával közzétett adatforrásokhoz. Az kapcsolati sztring szintaxissal kapcsolatos további információkért lásd: ConnectionString. |
| System.Data.Odbc | Adathozzáférést biztosít az ODBC használatával közzétett adatforrásokhoz. Az kapcsolati sztring szintaxissal kapcsolatos további információkért lásd: ConnectionString. |
| System.Data.OracleClient | Adathozzáférést biztosít az Oracle 8.1.7-es vagy újabb verziójához. Az kapcsolati sztring szintaxissal kapcsolatos további információkért lásd: ConnectionString. |
Kapcsolati karakterlánc-összeállítók
Használja a kapcsolatikarakterlánc-szerkesztőt az adatszolgáltatójához.
- SqlConnectionStringBuilder
- OleDbConnectionStringBuilder
- OdbcConnectionStringBuilder
- OracleConnectionStringBuilder
A kapcsolati sztringszerkesztők lehetővé teszik a szintaktikailag érvényes kapcsolati sztringek futásidőben történő összeállítását, így nem kell manuálisan összefűznie a kapcsolati sztring értékeit a kódban. További információ: Kapcsolati karakterlánc építők.
Windows-hitelesítés
A Windows-hitelesítés (más néven integrált biztonság) használható az azt támogató adatforrásokhoz való csatlakozáshoz. A kapcsolati sztring alkalmazott szintaxis szolgáltatónként eltérő. Az alábbi táblázat az adatszolgáltatókhoz használt Windows Hitelesítési szintaxist mutatja be.
| Szolgáltató | Szintaxis |
|---|---|
SqlClient |
Integrated Security=true;-- or --Integrated Security=SSPI; |
OleDb |
Integrated Security=SSPI; |
Odbc |
Trusted_Connection=yes; |
OracleClient |
Integrated Security=yes; |
Megjegyzés
Integrated Security=true kivételt jelez, ha a OleDb szolgáltatónál használják.
Fontos
A Microsoft azt javasolja, hogy a legbiztonságosabb hitelesítési folyamatot használja. Ha az Azure SQL-hez csatlakozik, az Azure-erőforrásokhoz használt felügyelt identitások az ajánlott hitelesítési módszer.
SqlClient-kapcsolati karakterláncok
A SqlConnection kapcsolati sztring szintaxisa a SqlConnection.ConnectionString tulajdonságban van dokumentálva. A ConnectionString tulajdonság használatával lekérhet vagy beállíthat kapcsolati sztring egy SQL Server-adatbázishoz. A legtöbb kapcsolati sztringek kulcsszavai is hozzárendelhetők a tulajdonságokhoz a SqlConnectionStringBuilder.
Fontos
A Persist Security Info kulcsszó alapértelmezett beállítása false.
true vagy yes beállítása lehetővé teszi, hogy a kapcsolat megnyitása után biztonsági szempontból érzékeny információkat, például a felhasználói azonosítót és a jelszót szerezzenek be a kapcsolatból. Hagyja Persist Security Infofalse beállításokkal, hogy a nem megbízható forrás ne férhessen hozzá bizalmas kapcsolati karakterlánc információkhoz.
Windows-hitelesítés az SqlClient használatával
Az alábbi szintaxisformák mindegyike Windows-hitelesítést használ a megadott kiszolgálón lévő AdventureWorks adatbázishoz való csatlakozáshoz.
"Persist Security Info=False;Integrated Security=true;Initial Catalog=AdventureWorks;Server=<server>;Encrypt=true"
"Persist Security Info=False;Integrated Security=SSPI;database=AdventureWorks;server=<server>;Encrypt=true"
"Persist Security Info=False;Trusted_Connection=True;database=AdventureWorks;server=<server>;Encrypt=true"
Fontos
A Microsoft azt javasolja, hogy a legbiztonságosabb hitelesítési folyamatot használja. Ha az Azure SQL-hez csatlakozik, az Azure-erőforrásokhoz használt felügyelt identitások az ajánlott hitelesítési módszer.
SQL Server-hitelesítés az SqlClient használatával
A Windows-hitelesítés ajánlott az SQL Serverhez való csatlakozáshoz helyben. Ha azonban SQL Server-hitelesítésre van szükség, használja az alábbi szintaxist a felhasználónév és a jelszó megadásához. Ebben a példában csillagokkal jelöljük az érvényes felhasználónevet és jelszót.
"Persist Security Info=False;User ID=*****;Password=*****;Initial Catalog=AdventureWorks;Server=MySqlServer"
Amikor az Azure SQL Database-hez vagy az Azure SQL Data Warehouse-hoz csatlakozik, és megadja a bejelentkezési formátumot user@servername, győződjön meg arról, hogy a servername bejelentkezési érték megegyezik a megadott Server=értékkel.
Megjegyzés
A Windows-hitelesítés elsőbbséget élvez az SQL Server-bejelentkezésekkel szemben. Ha mind a felhasználónevet, mind Integrated Security=true a jelszót megadja, a rendszer figyelmen kívül hagyja a felhasználónevet és a jelszót, és Windows-hitelesítést használ.
Fontos
A Microsoft azt javasolja, hogy a legbiztonságosabb hitelesítési folyamatot használja. Ha az Azure SQL-hez csatlakozik, az Azure-erőforrásokhoz használt felügyelt identitások az ajánlott hitelesítési módszer.
Csatlakozás az SQL Server nevesített példányához
Az SQL Server nevesített példányához való csatlakozáshoz használja a kiszolgálónév\példánynév szintaxisát.
"Data Source=<server>\\<instance>;Encrypt=true;"
A kapcsolati sztring létrehozásakor a DataSource tulajdonságot is beállíthatja a SqlConnectionStringBuilder példány nevére. Egy DataSource objektum SqlConnection tulajdonsága csak olvasható.
Rendszerverzió változásainak beírása
A Type System Version kulcsszó az SqlConnection.ConnectionString SQL Server-típusok ügyféloldali megjelenítését határozza meg. A kulcsszóval kapcsolatos további információkért Type System Version lásd: SqlConnection.ConnectionString.
Csatlakozás és csatolás SQL Server Express-felhasználói példányokhoz
A felhasználói példányok az SQL Server Express egyik funkciója. Lehetővé teszik, hogy a legkevésbé kiemelt helyi Windows-fiókon futó felhasználók rendszergazdai jogosultságok nélkül csatoljanak és futtassanak egy SQL Server-adatbázist. A felhasználói példány nem szolgáltatásként fut, hanem a felhasználó Windows-hitelesítő adataival.
A felhasználói példányok használatával kapcsolatos további információkért lásd: SQL Server Express User Instances.
A TrustServerCertificate használata
TrustServerCertificate=true Ezzel Encrypt=truetitkosítja a kapcsolatot, de megkerüli a kiszolgálótanúsítványok érvényesítését. Az éles kapcsolatokhoz tartsa meg a(z) TrustServerCertificate=false elemet, és konfiguráljon egy ellenőrizhető kiszolgálótanúsítványt.
"TrustServerCertificate=true;"
Caution
Ha megkerüli a tanúsítványérvényesítést, az ügyfél nem tudja ellenőrizni a kiszolgáló identitását. A Encrypt=Strict Microsoft.Data.SqlClient mindig ellenőrzi a kiszolgálótanúsítványt, és figyelmen kívül hagyja a TrustServerCertificate elemet.
Titkosítás engedélyezése
A Microsoft.Data.SqlClient alapértelmezett értéke Encrypt=true, ami egyenértékű a következőkkel: Encrypt=Mandatory és TrustServerCertificate=false. Az ügyfél titkosítást igényel, és ellenőrzi a kiszolgálótanúsítványt. Ha a tanúsítvány nem megbízható, vagy nem egyezik a kiszolgáló nevével, a kapcsolat meghiúsul.
Távoli kapcsolatok esetén adja meg a(z) Encrypt=true értéket, és konfiguráljon egy kiszolgálótanúsítványt, amelyben az ügyfél megbízik. Ha a System.Data.SqlClientről migrál, ne feltételezze, hogy annak alapértelmezett titkosítási beállításai a Microsoft.Data.SqlClientre is vonatkoznak. További információ: Titkosítás és tanúsítványérvényesítés a Microsoft.Data.SqlClientben.
OleDb kapcsolati karakterláncok
A ConnectionStringOleDbConnection tulajdonsága lehetővé teszi, hogy egy OLE DB-adatforráshoz, például a Microsoft Accesshez, egy kapcsolati karakterláncot lekérjen vagy beállítson. Futtatókörnyezetben is létrehozhat kapcsolati sztringet OleDb az OleDbConnectionStringBuilder osztály használatával.
OleDb kapcsolati sztring szintaxis
A OleDbConnection kapcsolati sztringhez meg kell adnia egy szolgáltató nevét. Az alábbi kapcsolati sztring egy Microsoft Access-adatbázishoz csatlakozik a Jet-szolgáltató használatával. Vegye figyelembe, hogy a User ID és a Password kulcsszavak nem kötelezőek, ha az adatbázis nem biztonságos (ez az alapértelmezett beállítás).
Provider=Microsoft.Jet.OLEDB.4.0; Data Source=d:\Northwind.mdb;User ID=Admin;Password=;
Ha a Jet-adatbázist felhasználói szintű biztonság védi, meg kell adnia a munkacsoport információs fájljának (.mdw) helyét. A munkacsoport információs fájlja a kapcsolat sztringben megadott hitelesítő adatok ellenőrzésére szolgál.
Provider=Microsoft.Jet.OLEDB.4.0;Data Source=d:\Northwind.mdb;Jet OLEDB:System Database=d:\NorthwindSystem.mdw;User ID=*****;Password=*****;
Fontos
Egy univerzális adatkapcsolati (UDL-) fájlban meg lehet adni kapcsolati információkat egy OleDbConnection, azonban ezt érdemes kerülni. Az UDL-fájlok nincsenek titkosítva, és kapcsolati sztring információkat világos szövegben teszik elérhetővé. Mivel az UDL-fájl az alkalmazás külső fájlalapú erőforrása, nem védhető .NET-keretrendszer használatával. Az SQLClient nem támogatja az UDL-fájlokat.
Fontos
A Microsoft azt javasolja, hogy a legbiztonságosabb hitelesítési folyamatot használja. Ha az Azure SQL-hez csatlakozik, az Azure-erőforrásokhoz használt felügyelt identitások az ajánlott hitelesítési módszer.
Csatlakozás az Accesshez/Jethez a DataDirectory használatával
DataDirectory nem kizárólagos a SqlClient. A .NET-adatszolgáltatókkal System.Data.OleDbSystem.Data.Odbc is használható. Az alábbi példasztring OleDbConnection az alkalmazás app_data mappájában található Northwind.mdb való csatlakozáshoz szükséges szintaxist mutatja be. A rendszeradatbázis (System.mdw) is ezen a helyen van tárolva.
"Provider=Microsoft.Jet.OLEDB.4.0;
Data Source=|DataDirectory|\Northwind.mdb;
Jet OLEDB:System Database=|DataDirectory|\System.mdw;"
Fontos
Nem szükséges megadni a rendszeradatbázis helyét a kapcsolati sztring, ha az Access/Jet adatbázis nem biztonságos. A biztonság alapértelmezés szerint ki van kapcsolva, és minden felhasználó egy üres jelszóval csatlakozik a beépített rendszergazdai felhasználóhoz. A Jet-adatbázisok akkor is sebezhetőek maradnak a támadással szemben, ha helyesen implementálják a felhasználói szintű biztonságot. Ezért az Access-/Jet-adatbázisok bizalmas adatainak tárolása nem ajánlott a fájlalapú biztonsági séma eredendő gyengesége miatt.
Csatlakozás az Excelhez
A Microsoft Jet-szolgáltató egy Excel-munkafüzethez való csatlakozásra szolgál. A következő kapcsolati sztringben a Extended Properties kulcsszó kifejezetten az Excelre jellemző tulajdonságokat állítja be. A "HDR=Igen;" azt jelzi, hogy az első sor oszlopneveket tartalmaz, nem adatokat, és az "IMEX=1;" azt jelzi, hogy az illesztő mindig szövegként olvassa fel az "összefűzött" adatoszlopokat.
Provider=Microsoft.Jet.OLEDB.4.0;Data Source=D:\MyExcel.xls;Extended Properties=""Excel 8.0;HDR=Yes;IMEX=1""
Vegye figyelembe, hogy a Extended Properties-hez szükséges idézőjel karaktert is idézőjelek közé kell foglalni.
Adatstruktúra-szolgáltató kapcsolati karaktersor szintaxis
A Microsoft Data Shape szolgáltató használatakor használja mind a Provider, mind a Data Provider kulcsszót. Az alábbi példa az Alakzatszolgáltatót használja az SQL Server helyi példányához való csatlakozáshoz.
"Provider=MSDataShape;Data Provider=SQLOLEDB;Data Source=(local);Initial Catalog=pubs;Integrated Security=SSPI;"
Fontos
A Microsoft azt javasolja, hogy a legbiztonságosabb hitelesítési folyamatot használja. Ha az Azure SQL-hez csatlakozik, az Azure-erőforrásokhoz használt felügyelt identitások az ajánlott hitelesítési módszer.
ODBC kapcsolati karakterláncok
A ConnectionString tulajdonsága a OdbcConnection lehetővé teszi egy kapcsolati lánc lekérését vagy beállítását egy OLE DB-adatforráshoz. Az ODBC kapcsolati sztringeket is támogatja a OdbcConnectionStringBuilder.
Az alábbi kapcsolati karakterlánc a Microsoft Szövegillesztőt használja.
Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=d:\bin
Oracle-kapcsolati karakterláncok
A ConnectionString tulajdonsága a OracleConnection lehetővé teszi egy kapcsolati lánc lekérését vagy beállítását egy OLE DB-adatforráshoz. Az Oracle-kapcsolati karakterláncokat is támogatja a OracleConnectionStringBuilder.
Data Source=Oracle9i;User ID=*****;Password=*****;
További információ az ODBC kapcsolati sztring szintaxisáról: ConnectionString.
Fontos
A Microsoft azt javasolja, hogy a legbiztonságosabb hitelesítési folyamatot használja. Ha az Azure SQL-hez csatlakozik, az Azure-erőforrásokhoz használt felügyelt identitások az ajánlott hitelesítési módszer.