SqlCeEngine.Compact メソッド

.NET Framework クラス ライブラリ リファレンス

SqlCeEngine.Compact メソッド

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

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

Visual Basic (宣言)

Public Sub Compact ( _
    connectionString As String _
)

Visual Basic (使用法)

Dim instance As SqlCeEngine
Dim connectionString As String

instance.Compact(connectionString)

C#

public void Compact (
    string connectionString
)

C++

public:
void Compact (
    String^ connectionString
)

J#

public void Compact (
    String connectionString
)

JScript

public function Compact (
    connectionString : String
)

パラメータ

connectionString

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

解説

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

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

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

使用例

SQL Server Mobile データベースを圧縮する例を次に示します。

Visual Basic

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;")

C#

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;");

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeEngine クラス
SqlCeEngine メンバ
System.Data.SqlServerCe 名前空間