SqlCeEngine 類別

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

命名空間：  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

備註

SQL Server Compact 3.5 並未最佳化，無法當做網站的資料庫。根據預設，SQL Server Compact 3.5 會封鎖從 ASP.NET 連接之應用程式所做的連接。SQL Server Compact 3.5 已最佳化，可以當做應用程式中的內嵌資料庫使用。使用 SQL Server Compact 3.5 做為網站的資料庫需要支援多使用者與並行資料變更。這可能會造成效能問題。因此，並不支援這些狀況。其他版本的 SQL Server (包括 SQL Server 2005 Express Edition 和更新版本) 都已最佳化，可以當做網站的資料庫。

SQL Server Compact 3.5 可以在使用 ASP.NET 建立 SQL Server Compact 3.5 資料庫 (適用於同步處理案例) 的應用程式案例中搭配 ASP.NET 使用。使用下列程式碼以變更 SQL Server Compact 3.5 的預設行為，以便在 ASP.NET 中運作。

AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", true)

範例

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

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();
}

繼承階層

System. . :: . .Object
  System.Data.SqlServerCe..::..SqlCeEngine

執行緒安全性

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

請參閱

參考

SqlCeEngine 成員

System.Data.SqlServerCe 命名空間