SqlCeEngine 類別

表示 SQL Server Compact 引擎物件的屬性、方法和其他物件。這個類別無法被繼承。

繼承階層

System.Object
  System.Data.SqlServerCe.SqlCeEngine

命名空間：  System.Data.SqlServerCe
組件：  System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)

語法

'宣告
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
'用途
Dim instance As SqlCeEngine

public sealed class SqlCeEngine : IDisposable

public ref class SqlCeEngine sealed : IDisposable

[<SealedAttribute>]
type SqlCeEngine =  
    class
        interface IDisposable
    end

public final class SqlCeEngine implements IDisposable

SqlCeEngine 型別公開下列成員。

建構函式

	名稱	說明
	SqlCeEngine()	初始化 SqlCeEngine 類別的新執行個體。
	SqlCeEngine(String)	使用指定的本機連接字串初始化 SqlCeEngine 類別的新執行個體。

上層

屬性

	名稱	說明
	LocalConnectionString	取得或設定 SQL Server Compact 資料庫的連接字串。

上層

方法

	名稱	說明
	Compact	從現有的檔案建立新的資料庫檔案，以回收在 SQL Server Compact 資料庫中浪費的空間。這個方法也用於變更資料庫的定序排序、加密或密碼設定。
	CreateDatabase	建立新的資料庫。
	Dispose	釋放所有 SQL Server CompactSqlCeEngine 資源。
	Equals	(繼承自 Object)
	Finalize	(繼承自 Object)
	GetHashCode	(繼承自 Object)
	GetType	(繼承自 Object)
	MemberwiseClone	(繼承自 Object)
	Repair	修復損毀的資料庫。
	Shrink	將空的分頁移至檔案尾端，然後截斷檔案，藉以回收在 SQL Server Compact 資料庫中浪費的空間。
	ToString	(繼承自 Object)
	Upgrade()	將 SQL Server Compact 資料庫的版本從 3.5 升級至 4.0。升級後如果來源資料庫已加密，資料庫將會進行加密。如果來源資料庫未加密，已升級資料庫將會變為未加密。
	Upgrade(String)	將 SQL Server Compact 資料庫的版本從 3.5 升級至 4.0。如果目的地連接字串中已指定加密模式，目的地資料庫將會進行加密。如果區分大小寫屬性在連接字串中設定為 true，資料庫定序將會區分大小寫。
	Verify()	重新計算資料庫中每一頁的總和檢查碼 (Checksum)，並比較新的總和檢查碼和預期的值。
	Verify(VerifyOption)	驗證以 VerifyOptio 為基礎的資料庫完整性。

上層

備註

SQL Server Compact 已最佳化，可當做網站和 Web 應用程式的資料庫使用。SQL Server Compact 已最佳化，可當做 Web 應用程式內的內嵌資料庫使用。SQL Server Compact 可當做網站的資料庫使用，適用於多名使用者與並行資料變更。

SQL Server Compact 可用來開發 ASP.NET Web 應用程式。在舊版的 SQL Server Compact 中，必須設定 SQLServerCompactEditionUnderWebHosting 旗標，才能在 ASP.NET Web 應用程式中使用 SQL Server Compact。SQL Server Compact 4.0 中已移除此旗標。

範例

下列範例示範如何建立新的 SQL Server Compact 資料庫。

If File.Exists("Test.sdf") Then
   File.Delete("Test.sdf")
End If 
Dim connStr As String = "Data Source = Test.sdf; Password = <password>"

Dim engine As New SqlCeEngine(connStr)
engine.CreateDatabase()
engine.Dispose()

Dim conn As SqlCeConnection = Nothing

Try
   conn = New SqlCeConnection(connStr)
   conn.Open()

   Dim cmd As SqlCeCommand = conn.CreateCommand()
   cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)"
   cmd.ExecuteNonQuery()
Catch
Finally
   conn.Close()
End Try

if (File.Exists("Test.sdf"))
    File.Delete("Test.sdf");

string connStr = "Data Source = Test.sdf; Password = <password>";

SqlCeEngine engine = new SqlCeEngine(connStr);
engine.CreateDatabase();
engine.Dispose();

SqlCeConnection conn = null;

try {
    conn = new SqlCeConnection(connStr);
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)";
    cmd.ExecuteNonQuery();
}
catch {}
finally {
    conn.Close();
}

執行緒安全性

這個類型的任何公用靜態 (在 Microsoft Visual Basic 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。

請參閱

參考

System.Data.SqlServerCe 命名空間