Classe SqlCeEngine
Rappresenta le proprietà, i metodi e altri oggetti dell'oggetto motore di SQL Server Compact. Questa classe non può essere ereditata.
System.Object
System.Data.SqlServerCe.SqlCeEngine
Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
'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.
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
Nome | Descrizione | |
---|---|---|
LocalConnectionString | Ottiene o imposta la stringa di connessione al database di SQL Server Compact. |
In alto
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
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.
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();
}
I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.