SqlCeConnection.ConnectionString プロパティ

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

データベースを開くために使用する文字列を取得または設定します。

Public Overridable Property ConnectionString As String  Implements _   IDbConnection.ConnectionString
[C#]
public virtual string ConnectionString {get; set;}
[C++]
public: __property virtual String* get_ConnectionString();public: __property virtual void set_ConnectionString(String*);
[JScript]
public function get ConnectionString() : String;public function set ConnectionString(String);

プロパティ値

データ ソース名を含む .NET Compact Framework Data Provider for SQL Server CE の接続文字列、および初期接続を確立するために必要なその他のパラメータ。既定値は空の文字列です。

実装

IDbConnection.ConnectionString

例外

解説

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

閉じた接続に対して ConnectionString をリセットすると、パスワードを含むすべての接続文字列値および関連プロパティがリセットされます。たとえば、Data Source =\my app\Northwind.sdf を指定した接続文字列を設定した後で、この文字列を Data Source =\my app\Master.sdf; Password=<Password> にリセットすると、 DataSource プロパティは Northwind.sdf に設定されなくなります。

SQL Server CE でサポートしている ConnectionString プロパティの一覧を次の表に示します。詳細については、SQL Server CE Books Online を参照してください。

プロパティの設定時には、接続文字列に対して予備的な検証が実行されます。アプリケーションが Open メソッドを呼び出したときは、接続文字列が完全に検証されます。接続文字列にサポートされないプロパティまたは無効なプロパティが含まれている場合は、実行時に、 ArgumentException などのランタイム例外が発生します。

値は、name='value'、name="value" など、単一引用符または二重引用符で区切ることができます。区切り文字として使用していない単一引用符または二重引用符は、接続文字列の中で使用できます。たとえば、name="value's" または name= 'value"s' と指定できます。name='value's' または name= ""value"" とは指定できません。値内または引用符内を除いて、空白文字はすべて無視されます。キーワードと値の組は、セミコロン (;) で区切る必要があります。セミコロンが値の一部である場合は、値を引用符で区切る必要があります。エスケープ シーケンスはサポートされません。値の型は無関係です。名前の大文字と小文字は区別されません。接続文字列内に同じプロパティ名が複数含まれている場合は、最後に出現するものに関連付けられた値が使用されます。

使用例

[Visual Basic, C#] SqlCeConnection を作成し、そのプロパティの一部を接続文字列に設定する例を次に示します。

 
Dim conn As New SqlCeConnection()
conn.ConnectionString = "Persist Security Info=False; Data Source = Northwind.sdf;" + _
  "Password = <password>; server=mySQLServer;Connect Timeout=30"

conn.Open()

[C#] 
SqlCeConnection conn = new SqlCeConnection();
conn.ConnectionString = "Persist Security Info=False; Data Source = Northwind.sdf;" + 
    "Password = <password>; server=mySQLServer;Connect Timeout=30";

conn.Open();

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

• 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

SqlCeConnection クラス | SqlCeConnection メンバ | System.Data.SqlServerCe 名前空間