SqlCeConnection クラス

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

継承階層

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

名前空間:  System.Data.SqlServerCe
アセンブリ:  System.Data.SqlServerCe (System.Data.SqlServerCe.dll)

構文

'宣言
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
'使用
Dim instance As SqlCeConnection

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

[<SealedAttribute>]
type SqlCeConnection =  
    class
        inherit DbConnection
    end

public final class SqlCeConnection extends DbConnection

SqlCeConnection 型は、以下のメンバーを公開しています。

コンストラクター

	名前	説明
	SqlCeConnection()	SqlCeConnection クラスの新しいインスタンスを初期化します。
	SqlCeConnection(String)	接続文字列を指定して、SqlCeConnection クラスの新しいインスタンスを初期化します。

Top

プロパティ

	名前	説明
	CanRaiseEvents	(Component から継承されます。)
	ConnectionString	データベースを開くために使用する文字列を取得または設定します。 (DbConnection.ConnectionString をオーバーライドします。)
	ConnectionTimeout	接続の確立の試行を開始してから、その試行を終了してエラーを生成するまでの待機時間を取得します。 (DbConnection.ConnectionTimeout をオーバーライドします。)
	Container	(Component から継承されます。)
	Database	現在のデータベース名、または接続が開いてから使用するデータベース名を取得します。 (DbConnection.Database をオーバーライドします。)
	DatabaseIdentifier	同期の実行中に現在のデータベースの一意の識別子を取得します。
	DataSource	データ ソースのファイル名を取得します。 (DbConnection.DataSource をオーバーライドします。)
	DbProviderFactory	(DbConnection から継承されます。)
	DesignMode	(Component から継承されます。)
	Events	(Component から継承されます。)
	ServerVersion	データベースのバージョン番号を文字列として返します。 (DbConnection.ServerVersion をオーバーライドします。)
	Site	(Component から継承されます。)
	State	接続の現在の状態を取得します。 (DbConnection.State をオーバーライドします。)

Top

メソッド

	名前	説明
	BeginDbTransaction	(DbConnection から継承されます。)
	BeginTransaction()	データベース トランザクションを開始します。
	BeginTransaction(IsolationLevel)	現在の IsolationLevel 値を使用して、データベース トランザクションを開始します。
	ChangeDatabase	開いている SqlCeConnection の現在のデータベースを変更します。 (DbConnection.ChangeDatabase(String) をオーバーライドします。)
	Close	データ ソースへの接続を閉じます。このメソッドは、開いている接続を閉じるための最も好ましいメソッドです。 (DbConnection.Close() をオーバーライドします。)
	CreateCommand	SqlCeConnection に関連付けられている SqlCeCommand オブジェクトを作成し、返します。
	CreateDbCommand	(DbConnection から継承されます。)
	CreateObjRef	(MarshalByRefObject から継承されます。)
	Dispose()	SqlCeConnection クラスの現在のインスタンスで使用されるすべてのリソースを解放します。
	Dispose(Boolean)	(Component から継承されます。)
	EnlistTransaction(Transaction)	(DbConnection から継承されます。)
	EnlistTransaction(Transaction)	指定された Transaction に参加します。
	Equals	(Object から継承されます。)
	Finalize	(Component から継承されます。)
	GetDatabaseInfo	接続されているデータベースのロケール情報、暗号化モード、および大文字と小文字の区別に関するキーと値のペアを返します。
	GetHashCode	(Object から継承されます。)
	GetLifetimeService	(MarshalByRefObject から継承されます。)
	GetSchema()	この SqlCeConnection のデータ ソースのスキーマ情報を返します。 (DbConnection.GetSchema() をオーバーライドします。)
	GetSchema(String)	スキーマ名に指定された文字列を使用して、この SqlCeConnection のデータ ソースのスキーマ情報を返します。 (DbConnection.GetSchema(String) をオーバーライドします。)
	GetSchema(String, array<String[])	スキーマ名に指定された文字列と制限値に指定された文字列配列を使用して、この SqlCeConnection のデータ ソースのスキーマ情報を返します。 (DbConnection.GetSchema(String, array<String[]) をオーバーライドします。)
	GetService	(Component から継承されます。)
	GetType	(Object から継承されます。)
	InitializeLifetimeService	(MarshalByRefObject から継承されます。)
	MemberwiseClone()	(Object から継承されます。)
	MemberwiseClone(Boolean)	(MarshalByRefObject から継承されます。)
	OnStateChange	(DbConnection から継承されます。)
	Open	ConnectionString で指定したプロパティ設定を使用して、データベース接続を開きます。 (DbConnection.Open() をオーバーライドします。)
	ToString	(Component から継承されます。)

Top

イベント

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

Top

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

	名前	説明
	IDbConnection.BeginTransaction()	(DbConnection から継承されます。)
	IDbConnection.BeginTransaction(IsolationLevel)	(DbConnection から継承されます。)
	IDbConnection.CreateCommand	(DbConnection から継承されます。)

Top

説明

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

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

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

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

使用例

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

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

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();
}

スレッド セーフ

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

関連項目

参照

System.Data.SqlServerCe 名前空間

SqlCeDataAdapter

SqlCeCommand