SqlCeEngine-Klasse
Stellt die Eigenschaften, Methoden und anderen Objekte des SQL Server Compact 3.5-Engine-Objekts dar. Diese Klasse kann nicht vererbt werden.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Syntax
'Declaration
Public NotInheritable Class SqlCeEngine _
Implements IDisposable
'Usage
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
Hinweise
SQL Server Compact 3.5 ist nicht für die Verwendung als Datenbank für Websites optimiert. Standardmäßig werden Verbindungen von Anwendungen, die mit ASP.NET verbunden sind, in SQL Server Compact 3.5 blockiert. SQL Server Compact 3.5 wurde für die Verwendung als eingebettete Datenbank in Anwendungen optimiert. Die Verwendung von SQL Server Compact 3.5 als Datenbank für Websites erfordert die Unterstützung von mehreren Benutzern und gleichzeitigen Datenänderungen. Dies kann Leistungsprobleme verursachen. Deshalb werden diese Szenarios nicht unterstützt. Andere Editionen von SQL Server, einschließlich SQL Server 2005 Express Edition und höher, wurden für die Verwendung als Datenbank für Websites optimiert.
SQL Server Compact 3.5 kann zusammen mit ASP.NET in Anwendungsszenarios verwendet werden, in denen ASP.NET für das Erstellen von SQL Server Compact 3.5-Datenbanken für die Synchronisierung verwendet wird. Verwenden Sie den folgenden Code, um das Standardverhalten von SQL Server Compact 3.5 zu ändern, damit diese Edition in ASP.NET verwendet werden kann.
AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", true)
Beispiele
Das folgende Beispiel veranschaulicht das Erstellen einer neuen SQL Server Compact 3.5-Datenbank.
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();
}
Vererbungshierarchie
System. . :: . .Object
System.Data.SqlServerCe..::..SqlCeEngine
Threadsicherheit
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.