SqlCeEngine.Compact Method

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

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

構文

'宣言
Public Sub Compact ( _
    connectionString As String _
)

public void Compact (
    string connectionString
)

public:
void Compact (
    String^ connectionString
)

public void Compact (
    String connectionString
)

public function Compact (
    connectionString : String
)

パラメータ

• connectionString
  接続先データベースへの接続文字列。

解説

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

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

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

重要 :
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;");

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

Windows Vista、Windows Mobile 5.0、Windows XP Professional with Service Pack 2 (SP2)、Windows Server 2003、Windows Mobile 2003 for Pocket PC、Windows CE 5.0
バージョン情報
.NET Framework および .NET Compact Framework
3.5 でサポート
.NET Framework
3.0 でサポート
.NET Compact Framework および .Net Framework
2.0 でサポート

参照

リファレンス

SqlCeEngine Class
SqlCeEngine Members
System.Data.SqlServerCe Namespace