SqlCeEngine Class

Articolo
01/14/2011

Rappresenta le proprietà, i metodi e altri oggetti dell'oggetto motore di SQL Server Compact 3.5. Questa classe non può essere ereditata.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
Public NotInheritable Class SqlCeEngine
    Implements IDisposable

public sealed class SqlCeEngine : IDisposable

public ref class SqlCeEngine sealed : IDisposable

public final class SqlCeEngine implements IDisposable

public final class SqlCeEngine implements IDisposable

Osservazioni

SQL Server Compact 3.5 non è ottimizzato per fungere da database per siti Web. Per impostazione predefinita, in SQL Server Compact 3.5 le connessioni da applicazioni collegate a ASP.NET vengono bloccate. SQL Server Compact 3.5 è ottimizzato per essere utilizzato come database incorporato all'interno di applicazioni. Per utilizzare SQL Server Compact 3.5 come database per siti Web, è necessario il supporto per più utenti e per le modifiche simultanee dei dati. Tale situazione può causare problemi di prestazioni, pertanto questi scenari non sono supportati. Altre edizioni di SQL Server, ad esempio SQL Server 2005 Express Edition e le versioni successive, sono ottimizzate per essere utilizzate come database per siti Web.

SQL Server Compact 3.5 può essere utilizzato con ASP.NET in scenari applicativi in cui ASP.NET viene utilizzato per creare database SQL Server Compact 3.5 per scenari di sincronizzazione. Per modificare il comportamento predefinito di SQL Server Compact 3.5 in modo che sia in grado di funzionare con ASP.NET, utilizzare il codice riportato di seguito.

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

Gerarchia di ereditarietà

System.Object
System.Data.SqlServerCe.SqlCeEngine

Esempio

Nell'esempio seguente vengono illustrate le modalità di creazione di un nuovo database di 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();
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeEngine Members
System.Data.SqlServerCe Namespace

Condividi tramite