Megosztás a következőn keresztül:

Kapcsolati sztringek

  • Cikk

Egy kapcsolati sztring használatával adhatja meg, hogyan csatlakozhat az adatbázishoz. A Microsoft.Data.Sqlite kapcsolati sztringjei a szabványos ADO.NET szintaxist követik a kulcsszavak és értékek pontosvesszővel tagolt listájaként.

Kulcsszavak

A Microsoft.Data.Sqlite-ben a következő kapcsolati sztring kulcsszavak használhatók:

Adatforrás

Az adatbázisfájl elérési útja. A DataSource (szóköz nélkül) és a Filename a kulcsszó aliasai.

Az SQLite az aktuális munkakönyvtárhoz képest kezeli az útvonalakat. Abszolút elérési utakat is meg lehet adni.

Ha üres, az SQLite létrehoz egy ideiglenes lemezen lévő adatbázist, amely a kapcsolat bezárásakor törlődik.

Ha :memory:a rendszer memórián belüli adatbázist használ. További információ: Memóriabeli adatbázisok.

A helyettesítési sztringgel |DataDirectory| kezdődő útvonalak a relatív elérési utakkal azonosak. Ha be van állítva, az elérési utak a DataDirectory alkalmazás tartománytulajdonság-értékéhez viszonyítva jönnek létre.

Ez a kulcsszó az URI-fájlneveket is támogatja.

Mód

A kapcsolati mód.

Érték Leírás
ReadWriteCreate Megnyitja az adatbázist olvasáshoz és íráshoz, és létrehozza, ha nem létezik. Ez az alapértelmezett beállítás.
ReadWrite Megnyitja az adatbázist olvasáshoz és íráshoz.
Olvasás Megnyitja az adatbázist írásvédett módban.
Memory (Memória) Megnyitja a memóriában lévő adatbázist.

Gyorsítótár

A kapcsolat által használt gyorsítótárazási mód.

Érték Leírás
Alapértelmezett Az alapul szolgáló SQLite-kódtár alapértelmezett módját használja. Ez az alapértelmezett beállítás.
Személyes Minden kapcsolat privát gyorsítótárat használ.
Megosztott A kapcsolatok gyorsítótárat használnak. Ez a mód megváltoztathatja a tranzakció és a tábla zárolásának viselkedését.

Jelszó

A titkosítási kulcs. Ha meg van adva, PRAGMA key a rendszer közvetlenül a kapcsolat megnyitása után küldi el.

Figyelmeztetés

A jelszónak nincs hatása, ha a natív SQLite-kódtár nem támogatja a titkosítást.

Feljegyzés

A Jelszó kulcsszó a 3.0-s verzióban lett hozzáadva.

Idegen kulcsok

Egy érték, amely azt jelzi, hogy engedélyezi-e az idegenkulcs-korlátozásokat.

Feljegyzés

A Foreign Keys kulcsszó a 3.0-s verzióban lett hozzáadva.

Érték Leírás
Igaz Közvetlenül a kapcsolat megnyitása után küld PRAGMA foreign_keys = 1 .
Hamis Közvetlenül a kapcsolat megnyitása után küld PRAGMA foreign_keys = 0 .
(üres) Nem küld .PRAGMA foreign_keys Ez az alapértelmezett beállítás.

Nem szükséges engedélyezni az idegen kulcsokat, ha az e_sqlite3 SQLITE_DEFAULT_FOREIGN_KEYS a natív SQLite-kódtár fordításához volt használva.

Rekurzív triggerek

Egy érték, amely jelzi, hogy engedélyezni szeretné-e a rekurzív triggereket.

Feljegyzés

A Rekurzív triggerek kulcsszó a 3.0-s verzióban lett hozzáadva.

Érték Leírás
Igaz Közvetlenül a kapcsolat megnyitása után küld PRAGMA recursive_triggers .
Hamis Nem küld .PRAGMA recursive_triggers Ez az alapértelmezett beállítás.

Alapértelmezett időtúllépés

A parancsok végrehajtásának alapértelmezett időtúllépése (másodpercben). Az alapértelmezett érték 30. A parancs időtúllépése a kulcsszó aliasa.

Ezt az értéket felül lehet bírálni DefaultTimeout , így felül lehet bírálni a használatával CommandTimeout.

Feljegyzés

Az alapértelmezett időtúllépési kulcsszó a 6.0-s verzióban lett hozzáadva.

Készletezés

Egy érték, amely jelzi, hogy a kapcsolat készletbe lesz-e állítva.

Feljegyzés

A készletezési kulcsszó a 6.0-s verzióban lett hozzáadva.

Érték Leírás
Igaz A kapcsolat össze lesz állítva. Ez az alapértelmezett beállítás.
Hamis A kapcsolat nem lesz készletben.

Vfs

Egy érték, amely azt jelzi, hogy melyik virtuális fájlrendszer (VFS) implementációt kell használni. Ha üres vagy nincs megadva, a platform alapértelmezett VFS-ét használja a rendszer.

Feljegyzés

A Vfs kulcsszó a 10.0-s verzióban lett hozzáadva.

Kapcsolati sztringszerkesztő

A kapcsolati sztring létrehozásának erősen gépelt módjaként is használhatóSqliteConnectionStringBuilder. A kapcsolati sztring injektálási támadások megelőzésére is használható.

var connectionString = new SqliteConnectionStringBuilder(baseConnectionString)
{
    Mode = SqliteOpenMode.ReadWriteCreate,
    Password = password
}.ToString();

Példák

Alap

Alapszintű kapcsolati sztring megosztott gyorsítótárral a jobb egyidejűség érdekében.

Figyelemfelhívás

A megosztott gyorsítótáras mód és az előre írási naplózás összekeverése nem ajánlott. Az optimális teljesítmény érdekében távolítsa el Cache=Shared , ha az adatbázis írás előtti naplózás használatára van konfigurálva.

Data Source=Application.db;Cache=Shared

Titkosított

Egy titkosított adatbázis.

Data Source=Encrypted.db;Password=MyEncryptionKey

Csak olvasható

Írásvédett adatbázis, amelyet az alkalmazás nem tud módosítani.

Data Source=Reference.db;Mode=ReadOnly

Memóriabeli

Egy privát, memórián belüli adatbázis.

Data Source=:memory:

Megosztható a memóriában

A Sharable név által azonosított, megosztható, memórián belüli adatbázis.

Data Source=Sharable;Mode=Memory;Cache=Shared

Lásd még