Connection strings

接続文字列は、データベースへの接続方法を指定するために使用されます。 Microsoft.Data.Sqlite の接続文字列は、セミコロンで区切られたキーワードと値のリストとして、標準の ADO.NET 構文に従っています。

キーワード

Microsoft.Data.Sqlite では次の接続文字列キーワードを使用できます。

Data Source

データベース ファイルのパス。 DataSource (スペースなし) と Filename はこのキーワードの別名です。

SQLite では、パスは現在の作業ディレクトリからの相対パスとして扱われます。 絶対パスも指定できます。

空の場合、一時的なディスク上のデータベースが作成されます。このデータベースは接続が閉じられるときに削除されます。

:memory: の場合、インメモリ データベースが使用されます。 詳細については、「インメモリ データベース」を参照してください。

|DataDirectory| 置換文字列で始まるパスは、相対パスと同じように扱われます。 設定すると、パスは DataDirectory アプリケーション ドメイン プロパティ値を基準とした相対パスになります。

このキーワードでは、URI ファイル名もサポートされます。

モード

接続モード。

キャッシュ

接続で使用されるキャッシュ モード。

パスワード

暗号化キー。 指定した場合、接続を開いた直後に PRAGMA key が送信されます。

外部キー

外部キー制約を有効にするかどうかを示す値です。

e_sqlite3 の場合のように、ネイティブ SQLite ライブラリをコンパイルするために SQLITE_DEFAULT_FOREIGN_KEYS が使用された場合は、外部キーを有効にする必要はありません。

再帰トリガー

再帰トリガーを有効にするかどうかを示す値です。

[Default Timeout](既定のタイムアウト)

コマンドを実行する場合の既定のタイムアウト (秒)。 既定値は 30 です。 Command Timeout は、このキーワードの別名です。

この値は DefaultTimeout を使用してオーバーライドできます。次に、それを CommandTimeout を使用してオーバーライドできます。

Pooling

接続をプールするかどうかを示す値です。

接続文字列ビルダー

SqliteConnectionStringBuilder は、厳密に型指定された方法で接続文字列を作成する際に使用できます。 接続文字列のインジェクション攻撃を防止するためにも使用できます。

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

例

Basic

コンカレンシーを向上させるために共有キャッシュを使用する基本的な接続文字列。

Data Source=Application.db;Cache=Shared

Encrypted

暗号化されたデータベース。

Data Source=Encrypted.db;Password=MyEncryptionKey

読み取り専用

アプリによって変更できない読み取り専用のデータベース。

Data Source=Reference.db;Mode=ReadOnly

メモリ内

非公開のインメモリ データベース。

Data Source=:memory:

共有可能なインメモリ

Sharable という名前で識別される、共有可能なインメモリ データベース。

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

関連項目

• ADO.NET での接続文字列
• インメモリ データベース
• トランザクション