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