Share via


SqlCeEngine 类

表示 Microsoft SQL Server 2005 Compact Edition 引擎对象的属性、方法及其他对象。无法继承此类。

命名空间: 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
public final class SqlCeEngine implements IDisposable
public final class SqlCeEngine implements IDisposable
不适用。

备注

目前未优化 SQL Server Compact Edition 来充当网站的数据库。默认情况下,在 SQL Server Compact Edition 中,来自与 ASP.NET 相连的应用程序的连接受到阻止。SQL Server Compact Edition 已经过优化,可用作应用程序内的嵌入式数据库。将 SQL Server Compact Edition 用作网站的数据库需要多用户和并发数据更改支持。这可能引起性能问题。因此,不支持这些方案。SQL Server 2005 的其他版本(包括 SQL Server 2005 Express Edition)已经过优化,可充当网站的数据库。

在 ASP.NET 用来为同步方案创建 SQL Server Compact Edition 数据库的应用程序方案中,SQL Server Compact Edition 可与 ASP.NET 一起使用。使用下面的代码更改 Compact Edition 的默认行为,以便在 ASP.NET 内使用。

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

示例

下面的示例演示如何新建 SQL Server Compact Edition 数据库。

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

线程安全

此类型的任何公共静态(Visual Basic 中的 Shared)成员都是线程安全的,但不保证所有实例成员都是线程安全的。

平台

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Windows Vista、Microsoft Windows XP SP2 和 Windows Server 2003 SP1 支持 Microsoft .NET Framework 3.0。

版本信息

.NET Framework

受以下版本支持:3.0

.NET Compact Framework

受以下版本支持:2.0、1.0

请参见

参考

SqlCeEngine 成员
System.Data.SqlServerCe 命名空间