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
	SqlCeEngine()	Inizializza una nuova istanza della classe SqlCeEngine.
	SqlCeEngine(String)	Inizializza una nuova istanza della classe SqlCeEngine con la stringa di connessione locale specificata.

In alto

Proprietà

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

In alto

Metodi

	Nome	Descrizione
	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.
	CreateDatabase	Crea un nuovo database.
	Dispose	Rilascia tutte le risorse SqlCeEngine di SQL Server Compact.
	Equals	(ereditato da Object)
	Finalize	(ereditato da Object)
	GetHashCode	(ereditato da Object)
	GetType	(ereditato da Object)
	MemberwiseClone	(ereditato da Object)
	Repair	Ripristina un database danneggiato.
	Shrink	Recupera lo spazio inutilizzato nel database di SQL Server Compact spostando le pagine vuote alla fine del file e successivamente troncando il file.
	ToString	(ereditato da Object)
	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.
	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.
	Verify()	Vengono ricalcolati i checksum di ogni pagina del database confrontando i nuovi checksum con i valori previsti.
	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