SqlCeConnection

.NET Framework クラス ライブラリ リファレンス

SqlCeConnection イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)
	FlushFailure	バックグラウンドでのフラッシュが失敗した場合に発生します。
	InfoMessage	.NET Compact Framework Data Provider for SQL Server が警告メッセージまたは情報メッセージを送信したときに発生します。
	StateChange	接続の状態が変更したときに発生します。

参照

関連項目

SqlCeConnection クラス
System.Data.SqlServerCe 名前空間
SqlCeDataAdapter
SqlCeCommand クラス

SqlCeConnection クラス

データ ソースへの開いた接続を表します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 SqlCeConnection
    Inherits DbConnection

Visual Basic (使用法)

Dim instance As SqlCeConnection

C#

public sealed class SqlCeConnection : DbConnection

C++

public ref class SqlCeConnection sealed : public
 DbConnection

J#

public final class SqlCeConnection extends
 DbConnection

JScript

public final class SqlCeConnection extends
 DbConnection

解説

SqlCeConnection オブジェクトは、データ ソースへの一意な接続を表します。SqlCeConnection のインスタンスを作成すると、すべてのプロパティが初期値に設定されます。これらの初期値の一覧については、SqlCeConnection コンストラクタのトピックを参照してください。

SqlCeConnection は、適用範囲外では閉じられません。そのため、Close または Dispose を呼び出して、明示的に接続を閉じる必要があります。

SQL Server Mobile では、複数のコマンドによる同一接続の共有、および複数の同時接続が、サポートされます。したがって、同じ接続で SqlCeDataReader の複数のインスタンスを開いて使用できます。この動作は、System.Data.SqlClient の動作とは異なります。

SqlCeCommand を実行するメソッドで致命的な SqlCeException が生成された場合、SqlCeConnection が閉じられる可能性があります。ユーザーは接続を再び開いて、処理を継続できます。

使用例

SqlCeCommand および SqlCeConnection を作成する例を次に示します。SqlCeConnection が開かれ、SqlCeCommand 用の Connection として設定されます。この例では、次に、ExecuteNonQuery を呼び出し、接続を閉じます。

Visual Basic

Dim conn As SqlCeConnection = Nothing

Try
    conn = New SqlCeConnection("Data Source = MyDatabase.sdf;
 Password ='<pwd>'")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name])
 Values('NWIND', 'Northwind Traders')"

    cmd.ExecuteNonQuery()
Finally
    conn.Close()
End Try

C#

SqlCeConnection conn = null;

try
{
    conn = new SqlCeConnection("Data Source = MyDatabase.sdf;
 Password ='<pwd>'");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name])
 Values('NWIND', 'Northwind Traders')";

    cmd.ExecuteNonQuery();
}
finally
{
    conn.Close();
}

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.SqlServerCe.SqlCeConnection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeConnection メンバ
System.Data.SqlServerCe 名前空間
SqlCeDataAdapter
SqlCeCommand クラス

SqlCeConnection コンストラクタ ()

SqlCeConnection クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SqlCeConnection

C#

public SqlCeConnection ()

C++

public:
SqlCeConnection ()

J#

public SqlCeConnection ()

JScript

public function SqlCeConnection ()

解説

SqlCeConnection の新しいインスタンスを作成すると、読み書き可能プロパティは、ConnectionString プロパティ内の対応するキーワードを使用して設定した場合を除いて、次の初期値に設定されます。

プロパティ	初期値
ConnectionString	空の文字列 ("")
DataSource	空の文字列 ("")

これらのプロパティの値を変更するには、ConnectionString プロパティを使用する必要があります。

使用例

SqlCeConnection を作成し、開く例を次に示します。

Visual Basic

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")

C#

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeConnection クラス
SqlCeConnection メンバ
System.Data.SqlServerCe 名前空間

SqlCeConnection コンストラクタ (String)

接続文字列を指定して、SqlCeConnection クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim connectionString As String

Dim instance As New SqlCeConnection(connectionString)

C#

public SqlCeConnection (
    string connectionString
)

C++

public:
SqlCeConnection (
    String^ connectionString
)

J#

public SqlCeConnection (
    String connectionString
)

JScript

public function SqlCeConnection (
    connectionString : String
)

パラメータ

connectionString

データベースを開くために使用する接続。

解説

SqlCeConnection の新しいインスタンスを作成すると、読み書き可能プロパティは、ConnectionString プロパティ内の対応するキーワードを使用して設定した場合を除いて、次の初期値に設定されます。

プロパティ	初期値
ConnectionString	connectionString
DataSource	空の文字列 ("")

これらのプロパティの値を変更するには、ConnectionString プロパティを使用する必要があります。

使用例

SqlCeConnection を作成し、開く例を次に示します。

Visual Basic

Dim conn As SqlCeConnection = Nothing

Try
    conn = New SqlCeConnection("Data Source = MyDatabase.sdf;
 Password ='<pwd>'")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name])
 Values('NWIND', 'Northwind Traders')"

    cmd.ExecuteNonQuery()
Finally
    conn.Close()
End Try

C#

SqlCeConnection conn = null;

try
{
    conn = new SqlCeConnection("Data Source = MyDatabase.sdf;
 Password ='<pwd>'");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name])
 Values('NWIND', 'Northwind Traders')";

    cmd.ExecuteNonQuery();
}
finally
{
    conn.Close();
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeConnection クラス
SqlCeConnection メンバ
System.Data.SqlServerCe 名前空間

SqlCeConnection コンストラクタ

SqlCeConnection クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
SqlCeConnection ()	SqlCeConnection クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
SqlCeConnection (String)	接続文字列を指定して、SqlCeConnection クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

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

SqlCeConnection プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionString	オーバーライドされます。 データベースを開くために使用する文字列を取得または設定します。
	ConnectionTimeout	オーバーライドされます。 接続の確立の試行を開始してから、その試行を終了してエラーを生成するまでの待機時間を取得します。
	Database	オーバーライドされます。 現在のデータベース名、または接続が開いてから使用するデータベース名を取得します。
	DataSource	オーバーライドされます。 データ ソースのファイル名を取得します。SQL Server Mobile では、データベースは、常に個別のファイルに格納されます。
	ServerVersion	オーバーライドされます。 SQL Server Mobile のバージョン番号を文字列として返します。
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	State	オーバーライドされます。 接続の現在の状態を取得します。

プロテクト プロパティ

	名前	説明
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

SqlCeConnection クラス
System.Data.SqlServerCe 名前空間
SqlCeDataAdapter
SqlCeCommand クラス

SqlCeConnection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginTransaction	オーバーロードされます。 データベース トランザクションを開始します。
	ChangeDatabase	オーバーライドされます。 開いている SqlCeConnection の現在のデータベースを変更します。
	Close	オーバーライドされます。 データ ソースへの接続を閉じます。このメソッドは、開いている接続を閉じるための最も好ましいメソッドです。
	CreateCommand	SqlCeConnection に関連付けられている SqlCeCommand オブジェクトを作成し、返します。
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetSchema	オーバーロードされます。 この DbConnection のデータ ソースのスキーマ情報を返します。 ( DbConnection から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Open	オーバーライドされます。 ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	BeginDbTransaction	データベース トランザクションを開始します。 ( DbConnection から継承されます。)
	CreateDbCommand	現在の接続に関連付けられている DbCommand オブジェクトを作成し、返します。 ( DbConnection から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnStateChange	StateChange イベントを発生させます。 ( DbConnection から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Data.IDbConnection.BeginTransaction	オーバーロードされます。
	System.Data.IDbConnection.CreateCommand

参照

関連項目

SqlCeConnection クラス
System.Data.SqlServerCe 名前空間
SqlCeDataAdapter
SqlCeCommand クラス

SqlCeConnection メンバ

データ ソースへの開いた接続を表します。

SqlCeConnection データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	SqlCeConnection	オーバーロードされます。 SqlCeConnection クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionString	オーバーライドされます。 データベースを開くために使用する文字列を取得または設定します。
	ConnectionTimeout	オーバーライドされます。 接続の確立の試行を開始してから、その試行を終了してエラーを生成するまでの待機時間を取得します。
	Database	オーバーライドされます。 現在のデータベース名、または接続が開いてから使用するデータベース名を取得します。
	DataSource	オーバーライドされます。 データ ソースのファイル名を取得します。SQL Server Mobile では、データベースは、常に個別のファイルに格納されます。
	ServerVersion	オーバーライドされます。 SQL Server Mobile のバージョン番号を文字列として返します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	State	オーバーライドされます。 接続の現在の状態を取得します。

プロテクト プロパティ

	名前	説明
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginTransaction	オーバーロードされます。 データベース トランザクションを開始します。
	ChangeDatabase	オーバーライドされます。 開いている SqlCeConnection の現在のデータベースを変更します。
	Close	オーバーライドされます。 データ ソースへの接続を閉じます。このメソッドは、開いている接続を閉じるための最も好ましいメソッドです。
	CreateCommand	SqlCeConnection に関連付けられている SqlCeCommand オブジェクトを作成し、返します。
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetSchema	オーバーロードされます。 この DbConnection のデータ ソースのスキーマ情報を返します。 (DbConnection から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Open	オーバーライドされます。 ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	BeginDbTransaction	データベース トランザクションを開始します。 (DbConnection から継承されます。)
	CreateDbCommand	現在の接続に関連付けられている DbCommand オブジェクトを作成し、返します。 (DbConnection から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnStateChange	StateChange イベントを発生させます。 (DbConnection から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)
	FlushFailure	バックグラウンドでのフラッシュが失敗した場合に発生します。
	InfoMessage	.NET Compact Framework Data Provider for SQL Server が警告メッセージまたは情報メッセージを送信したときに発生します。
	StateChange	接続の状態が変更したときに発生します。

明示的インターフェイスの実装

	名前	説明
	System.Data.IDbConnection.BeginTransaction	オーバーロードされます。
	System.Data.IDbConnection.CreateCommand

参照

関連項目

SqlCeConnection クラス
System.Data.SqlServerCe 名前空間
SqlCeDataAdapter
SqlCeCommand クラス