次の方法で共有


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