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


Kapcsolati karakterláncok

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
OlvassÍrjKészíts Megnyitja az adatbázist olvasáshoz és íráshoz, és létrehozza, ha nem létezik. Ez az alapértelmezett beállítás.
OlvasásÍrás Megnyitja az adatbázist olvasáshoz és íráshoz.
Csak olvasható Megnyitja az adatbázist csak olvasási módban.
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.
Privát Minden kapcsolat privát gyorsítótárat használ.
Közös 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.

Megjegyzé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.

Megjegyzé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 például az e_sqlite3 esetében a natív SQLite könyvtár fordításához SQLITE_DEFAULT_FOREIGN_KEYS-t használták.

Rekurzív triggerek

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

Megjegyzé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. Command Timeout e kulcsszó szinonimája.

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

Megjegyzés

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

Erőforrás-csoportosítás

Egy érték, amely jelzi, hogy a kapcsolat poolozott lesz-e.

Megjegyzés

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

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

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.

Megjegyzés

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

Kapcsolati karaktersor szerkesztő

A SqliteConnectionStringBuilder használható erősen gépelt módként a kapcsolati sztringek létrehozásához. A kapcsolat karakterlánc 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

Alapszintű

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 megosztható, memóriában lévő adatbázis, amelyet a Sharable név azonosít.

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

Lásd még