LocalConnectionString プロパティ (SQL Server Compact Edition)

  • [アーティクル]

ローカルの Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition) データベースの接続文字列を指定します。

構文

object.LocalConnectionString

プロパティ

要素 説明

Object

SQL Server Compact Edition Engine オブジェクト

属性

読み取り専用

解説

LocalConnectionString プロパティは、接続が閉じているときにのみ設定できます。接続文字列の多くは、その値に対応する読み取り専用のプロパティがあります。エラーが検出された場合を除き、接続文字列を設定すると、これらのすべてのプロパティが更新されます。この場合、いずれのプロパティも更新されません。

閉じている接続で LocalConnectionString をリセットすると、接続文字列値および関連するプロパティ (パスワードなど) もすべてリセットされます。

次の表は、SQL Server Compact Edition でサポートされる LocalConnectionString プロパティの一覧です。

プロパティ

説明

data source

SQL Server Compact Edition データベース ファイルのパスと名前。

メモ :
データベース ファイルは絶対パスで指定する必要があります。相対パスは使用できません。

ssce: database password

データベース パスワード (最大 40 文字)。指定されていない場合、既定ではパスワードは設定されません。データベースで暗号化を有効にする場合、このプロパティは必須です。パスワードを指定すると、データベースで暗号化が有効になります。

ssce: encrypt database

データベースを暗号化するかどうかを指定するブール値。暗号化を有効にする場合は true に設定し、無効にする場合は false に設定します。指定されていない場合、既定値は false です。暗号化を有効にする場合は、password プロパティでパスワードを指定する必要があります。パスワードを指定すると、このプロパティの設定値にかかわらず、暗号化が有効になります。

ssce: max buffer size

変更内容がディスクにフラッシュされるまでに SQL Server Compact Edition が使用できるメモリの最大容量 (KB 単位)。指定されていない場合、既定値は 640 です。

ssce: max database size

データベースの最大サイズ (MB 単位)。指定されていない場合、既定値は 128 です。

ssce:mode

データベース ファイルを開くときに使用するモード。有効な値については、次の表を参照してください。指定されていない場合、既定値は読み取り/書き込みです。

ssce: default lock timeout

トランザクションがロックを待機する既定の間隔 (ミリ秒)。指定されていない場合、既定値は 2000 です。

ssce: default lock escalation

行からページへ、またはページからテーブルへのエスカレートを実行する前に、トランザクションが取得するロックの数。指定されていない場合、既定値は 100 です。

ssce: flush interval

コミットされたすべてのトランザクションがディスクにフラッシュされるまでの時間 (秒単位)。指定されていない場合、既定値は 10 です。

ssce: autoshrink threshold

自動圧縮の開始前に許可されるデータベース ファイル内の空き領域の割合。この値を 100 にすると、自動圧縮が無効になります。指定されていない場合、既定値は 60 です。

ssce: temp file directory

一時データベースの場所。指定されていない場合、既定では、データ ソース プロパティに指定されたデータベースが一時的な格納場所として使用されます。

ssce: temp file max size

一時データベース ファイルの最大サイズ (MB 単位)。指定されていない場合、既定値は 128 です。

locale identifier

データベースで使用するロケール ID (LCID)。

次の表に、接続文字列で有効な mode プロパティの値を示します。

値

定義

Read Write

データベースを開く操作と変更する操作を、複数のプロセスに許可します。mode プロパティを指定しなかった場合、これが既定の設定です。

Read Only

データベースの読み取り専用のコピーを開くことができます。

Exclusive

他のプロセスがデータベースを開いたり変更したりできないようにします。

Shared Read

あるプロセスがデータベースを開いているとき、他のプロセスには読み取りのみを許可し、変更はできないようにします。

次の規則は、接続文字列に適用されます。

  1. 空白文字が値の中で使用されている場合、または引用符で囲まれている場合を除き、すべての空白文字を無視します。

  2. キーワード値のペアはセミコロン (;) で区切る必要があります。また、セミコロンそのものが値の一部として使用されている場合は、セミコロンを引用符で区切る必要があります。

  3. エスケープ シーケンスは、サポートされていません。

  4. 値の型は認識されません。

  5. 名前の大文字と小文字は区別されません。

  6. 接続文字列に同じプロパティ名を複数指定した場合、最後に指定されている値が使用されます。

  7. 値は単一引用符または二重引用符で区切ることができます (name='value' or name="value" など)。1 つの接続文字列内で、単一引用符と二重引用符を混在させることができます。たとえば、次のように 1 つの接続文字列内で異なる引用符を使用できます。

    "data source='MyDb.sdf'; ssce: mode=Exclusive;"
'data source="MyDb.sdf"; ssce: mode=Exclusive;'
But these examples are not valid:
"data source="MyDb.sdf"; ssce: mode=Exclusive;"
'data source='MyDb.sdf'; ssce: mode=Exclusive;'

参照

関連項目

SSCEError オブジェクト
CompactDatabase メソッド (SQL Server Compact Edition)
SSCEErrors コレクション

ヘルプおよび情報

SQL Server Compact Edition のサポートについて