SqlCeEngine.Compact メソッド
既存のデータベース ファイルから新しいデータベース ファイルを作成し、SQL Server Compact データベース内の使用済み領域をクリアします。このメソッドは、データベースの照合順序、暗号化、またはパスワードの設定変更にも使用されます。
名前空間: 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
)
パラメーター
- connectionString
型: System.String
接続先データベースへの接続文字列。
説明
このメソッドで作成される接続先データベースへの接続を指定する接続文字列。
指定したデータベースが既に存在する場合、または同じ名前の他のファイルが既に存在する場合は、例外がスローされます。.
接続文字列に空の文字列を渡すと、古いデータベース ファイルが新しいデータベース ファイルによって上書きされ、同じ名前が使用されます。
重要
Compact 操作が完了する前にアプリケーションが異常終了した場合、システムに一時データベース ファイルが残されます。このファイルの名前は <filename>pack.sdf であり、手動で削除する必要があります。
使用例
SQL Server Compact データベースを最適化する方法を次の例に示します。
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;");