Condividi tramite


Classe SqlCeEngine

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

Gerarchia di ereditarietà

System.Object
  System.Data.SqlServerCe.SqlCeEngine

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

Sintassi

'Dichiarazione
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
'Utilizzo
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

Nel tipo SqlCeEngine sono esposti i membri seguenti.

Costruttori

  Nome Descrizione
Metodo pubblico SqlCeEngine() Inizializza una nuova istanza della classe SqlCeEngine.
Metodo pubblico SqlCeEngine(String) Inizializza una nuova istanza della classe SqlCeEngine con la stringa di connessione locale specificata.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica LocalConnectionString Ottiene o imposta la stringa di connessione al database di SQL Server Compact.

In alto

Metodi

  Nome Descrizione
Metodo pubblico Compact Recupera lo spazio inutilizzato nel database di SQL Server Compact creando un nuovo file di database dal file esistente. Questo metodo viene utilizzato anche per modificare le impostazioni dell'ordine di confronto, della crittografia o della password del database.
Metodo pubblico CreateDatabase Crea un nuovo database.
Metodo pubblico Dispose Rilascia tutte le risorse SqlCeEngine di SQL Server Compact.
Metodo pubblico Equals (ereditato da Object)
Metodo protetto Finalize (ereditato da Object)
Metodo pubblico GetHashCode (ereditato da Object)
Metodo pubblico GetType (ereditato da Object)
Metodo protetto MemberwiseClone (ereditato da Object)
Metodo pubblico Repair Ripristina un database danneggiato.
Metodo pubblico Shrink Recupera lo spazio inutilizzato nel database di SQL Server Compact spostando le pagine vuote alla fine del file e successivamente troncando il file.
Metodo pubblico ToString (ereditato da Object)
Metodo pubblico Upgrade() Aggiorna un database di SQL Server Compact dalla versione 3.5 alla versione 4.0. Dopo l'aggiornamento, verrà applicata la crittografia se il database di origine era crittografato. In caso contrario, il database aggiornato non sarà crittografato.
Metodo pubblico Upgrade(String) Aggiorna un database di SQL Server Compact dalla versione 3.5 alla versione 4.0. Il database di destinazione verrà crittografato se nella stringa di connessione di destinazione è stata specificata la modalità di crittografia. Le regole di confronto del database rispetteranno la distinzione tra maiuscole e minuscole se la relativa proprietà è impostata su true nella stringa di connessione.
Metodo pubblico Verify() Vengono ricalcolati i checksum di ogni pagina del database confrontando i nuovi checksum con i valori previsti.
Metodo pubblico Verify(VerifyOption) Verifica l'integrità del database in base a VerifyOption.

In alto

Osservazioni

SQL Server Compact è ottimizzato per fungere da database per siti Web e applicazioni Web. SQL Server Compact è ottimizzato per l'utilizzo come database incorporato all'interno di applicazioni. SQL Server Compact può essere utilizzato come un database per i siti Web per più utenti e modifiche dei dati simultanee.

SQL Server Compact può essere utilizzato per sviluppare applicazioni Web ASP.NET. Nelle versioni precedenti di SQL Server Compact era necessario impostare il flag SQLServerCompactEditionUnderWebHosting per utilizzare SQL Server Compact nelle applicazioni Web ASP.NET. Il flag è stato rimosso in SQL Server Compact 4.0.

Esempi

Nell'esempio seguente viene illustrata la modalità di creazione di un nuovo database di 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();
}

Protezione dei thread

I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe