SqlCeConnection.ConnectionString プロパティ
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文Dim instance As SqlCeConnection Dim value As String value = instance.ConnectionString instance.ConnectionString = value
public: virtual property String^ ConnectionString { String^ get () override; void set (String^ value) override; }
/** @property */ public String get_ConnectionString () /** @property */ public void set_ConnectionString (String value)
public override function get ConnectionString () : String public override function set ConnectionString (value : String)
データ ソース名を含む .NET Compact Framework Data Provider for SQL Server Mobile の接続文字列、および初期接続を確立するために必要なその他のパラメータ。既定値は空の文字列です。
例外解説ConnectionString プロパティを設定できるのは、接続が閉じているときだけです。接続文字列値の多くには、対応する読み取り専用プロパティがあります。接続文字列を設定すると、エラーが検出された場合を除いて、これらのプロパティがすべて更新されます。エラーが発生した場合は、いずれのプロパティも更新されません。SqlCeConnection プロパティは、ConnectionString に含まれている設定だけを返します。
閉じた接続に対して ConnectionString をリセットすると、パスワードを含むすべての接続文字列値および関連プロパティがリセットされます。
SQL Server Mobile でサポートしている ConnectionString プロパティの一覧を次の表に示します。詳細については、SQL Server Mobile Books Online を参照してください。
data sourceSQL Mobile データベースのファイル パスとファイル名。
passwordデータベースのパスワード。40 文字まで指定できます。指定しない場合、既定値では、パスワードが使用されません。このプロパティは、データベースで暗号化を有効にする場合に必要です。パスワードを指定した場合、暗号化がデータベースで自動的に有効になります。
encryptデータベースを暗号化するかどうかを表すブール値。暗号化を有効にする場合は、true を設定し、暗号化を無効にする場合は、false を設定します。指定しない場合、既定値は false です。暗号化を有効にする場合は、password プロパティでパスワードを指定する必要があります。パスワードを指定すると、このプロパティの設定に関係なく、暗号化が有効になります。
max buffer sizeSQL Server Mobile で使用可能なメモリの最大サイズ (KB 単位)。これを超えると、変更はディスクにフラッシュされます。指定しない場合、既定値は 640 です。
max database sizeデータベースの最大サイズ (MB 単位)。指定しない場合、既定値は 128 です。
modeデータベース ファイルを開くときに使用するモード。有効なモードについては、次の表を参照してください。指定しない場合、既定値は "Read Write" です。
default lock timeoutトランザクションがロックを待機する既定の期間 (ミリ秒)。指定しない場合、既定値は 2000 です。
default lock escalationトランザクションが行からページ、またはページからテーブルへとエスカレーションを試みるまでに取得するロックの数。指定しない場合、既定値は 100 です。
flush intervalコミットされたすべてのトランザクションがディスクにフラッシュされるまでの時間間隔 (秒単位) を指定します。指定しない場合、既定値は 10 です。
autoshrink threshold自動圧縮が開始されるまで、データベース ファイルに許容されている空き容量の割合 (%)。値を 100 に設定すると、自動圧縮が無効になります。指定しない場合、既定値は 60 です。
temp path一時データベースの場所。指定しない場合、既定では、一時保存に使用されるデータ ソース プロパティで指定したデータベースです。
temp file max size一時データベースの最大サイズ (MB 単位)。指定しない場合、既定値は 128 です。
persist security infofalse に設定すると (推奨)、接続が開いているか、開いている状態になったことがある場合に、パスワードなどの機密性の高い情報が接続文字列の一部として返されません。接続文字列をリセットすると、パスワードを含むすべての接続文字列値がリセットされます。既定値は false です。
locale identifierこのデータベースで使用するロケール ID (LCID)。有効な LCID の値は、CultureInfo クラスにリストされています。
接続文字列の mode プロパティの有効値を、次の表に示します。
Read Write複数のプロセスがデータベースを開いて変更できるようにします。mode プロパティを指定していない場合は、この値が既定値になります。
Read Only Exclusive他のプロセズがデータベースを開いたり、変更したりできないようにします。
Shared Readデータベースを開いている間も、他のプロセスからの読み取りを許可しますが、他のプロセスからの変更は禁止します。
プロパティの設定時には、接続文字列に対して予備的な検証が実行されます。アプリケーションが Open メソッドを呼び出したときは、接続文字列が完全に検証されます。接続文字列にサポートされないプロパティまたは無効なプロパティが含まれている場合は、実行時に、ArgumentException などのランタイム例外が発生します。
使用例SqlCeConnection を作成し、そのプロパティの一部を接続文字列に設定する例を次に示します。
Dim conn As New SqlCeConnection() ' Set some connection string properties e.g.: ' conn.ConnectionString = _ "Persist Security Info = False; Data Source = 'SalesData.sdf';" & _ "Password = '<password>'; File Mode = 'shared read'; " & _ "Max Database Size = 256; Max Buffer Size = 1024" conn.Open() ' You can change the database while preserving ' the orignal connection options ' conn.ChangeDatabase("SupportData.sdf")
SqlCeConnection conn = new SqlCeConnection(); // Set some connection string properties e.g.: // conn.ConnectionString = "Persist Security Info = False; Data Source = 'SalesData.sdf';" + "Password = '<password>'; File Mode = 'shared read'; " + "Max Database Size = 256; Max Buffer Size = 1024"; conn.Open(); // You can change the database while preserving // the orignal connection options // conn.ChangeDatabase("SupportData.sdf");
.NET Framework のセキュリティプラットフォームWindows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- SqlCeConnection.ConnectionString プロパティのページへのリンク
