Compact メソッド

既存のデータベース ファイルから新しいデータベース ファイルを作成し、SQL Server Compact 3.5 データベース内の使用済み領域をクリアします。このメソッドは、データベースの照合順序、暗号化、またはパスワードの設定変更にも使用されます。

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

構文

'宣言
Public Sub Compact ( _
    connectionString As String _
)
'使用
Dim instance As SqlCeEngine
Dim connectionString As String

instance.Compact(connectionString)
public void Compact(
    string connectionString
)
public:
void Compact(
    String^ connectionString
)
member Compact : 
        connectionString:string -> unit 
public function Compact(
    connectionString : String
)

パラメーター

説明

このメソッドで作成される接続先データベースへの接続を指定する接続文字列。

指定したデータベースが既に存在する場合、または同じ名前の他のファイルが既に存在する場合は、例外がスローされます。.

接続文字列に空の文字列を渡すと、古いデータベース ファイルが新しいデータベース ファイルによって上書きされ、同じ名前が使用されます。

重要

Compact 操作が完了する前にアプリケーションが異常終了した場合、システムに一時データベース ファイルが残されます。このファイルの名前は <filename>pack.sdf であり、手動で削除する必要があります。

使用例

SQL Server Compact 3.5 データベースを最適化する方法を次の例に示します。

Dim engine As New SqlCeEngine("Data Source = AdventureWorks.sdf")

' Specify null destination connection string for in-place compaction
'
engine.Compact(Nothing)

' Specify connection string for new database options; The following 
' tokens are valid:
'      - Password
'      - LCID
'      - Encrypt
' 
' All other SqlCeConnection.ConnectionString tokens are ignored
'
engine.Compact("Data Source=; Password =a@3!7f$dQ;")
SqlCeEngine engine = new SqlCeEngine("Data Source = AdventureWorks.sdf");

// Specify null destination connection string for in-place compaction
//
engine.Compact(null);

// Specify connection string for new database options; The following 
// tokens are valid:
//      - Password
//      - LCID
//      - Encrypt
// 
// All other SqlCeConnection.ConnectionString tokens are ignored
//
engine.Compact("Data Source=; Password =a@3!7f$dQ;");

関連項目

参照

SqlCeEngine クラス

SqlCeEngine メンバー

System.Data.SqlServerCe 名前空間