SqlClient-támogatás a LocalDB-hez

Használja a Microsoft.Data.SqlClient NuGet-csomagot a LocalDB-hez való csatlakozáshoz, amely a Windowson elérhető SQL Server egyszerűsített verziója. A cikkben szereplő példákhoz használja Windows integrált hitelesítést.

Megjegyzések

A LocalDB-vel elvégezhető műveletek összegzése:

  • Hozzon létre és indítson el LocalDB-példányokat a(z) SqlLocalDB.exe használatával.

  • A sqlcmd.exe használatával adhat hozzá és módosíthat adatbázisokat egy LocalDB-példányban. Például: sqlcmd -S (localdb)\myinst.

  • Adjon hozzá egy adatbázist a LocalDB-példányához a AttachDBFilename kapcsolati sztring kulcsszóval. Amikor a AttachDBFilename használatban van, ha nem adja meg az adatbázis nevét a Database kapcsolati sztring kulcsszóval, az adatbázis törlődni fog a LocalDB-példányból, amikor az alkalmazás bezárul.

  • Adjon meg egy LocalDB-példányt a kapcsolati sztringben. Például, ha a példány neve myInstance, akkor a kapcsolati sztring a következőképpen alakulna:

    Server=(localdb)\myInstance;Database=<database>;Integrated Security=true;Encrypt=true

User Instance=True LocalDB-adatbázishoz való csatlakozáskor nem engedélyezett.

További információ a LocalDB telepítéséről: SQL Server Express LocalDB.

Elnevezett példány programozott létrehozása

A modern .NET-ben a Microsoft.Data.SqlClient nem használja a .NET-keretrendszer system.data.localdb konfigurációs szakaszát. Hozza létre és indítsa el a példányt, mielőtt az alkalmazás megnyit egy kapcsolatot:

SqlLocalDB.exe create myInstance
SqlLocalDB.exe start myInstance

Adja meg ugyanazt a példánynevet a Server kapcsolatisztring-kulcsszóban. Meglévő adatbázisfájl csatolásához állítsa be a(z) AttachDBFilename értékét a fájl teljes elérési útjára, és állítsa be a(z) Database értékét az adatbázis nevére.

Ha olyan LocalDB-példányt használ, amely nem rendelkezik megbízható kiszolgálótanúsítvánnyal, használja a következőt: Encrypt=true;TrustServerCertificate=true Ez a beállítás titkosítja a kapcsolatot, de kihagyja a kiszolgálótanúsítvány érvényesítését. Távoli éles kapcsolatokhoz használjon Encrypt=true;TrustServerCertificate=false és konfiguráljon egy kiszolgálói tanúsítványt, amelyben az ügyfél megbízik, és amely egyezik a kiszolgáló nevével. További információ: Titkosítás és tanúsítványérvényesítés a Microsoft.Data.SqlClientben.

Lásd még