Classe SqlCeConnection

Articolo
01/17/2011

Rappresenta una connessione aperta a un'origine dati di SQL Server Compact 3.5.

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

Sintassi

'Dichiarazione
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
'Utilizzo
Dim instance As SqlCeConnection

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

[<SealedAttribute>]
type SqlCeConnection =  
    class
        inherit DbConnection
    end

public final class SqlCeConnection extends DbConnection

Osservazioni

Un oggetto SqlCeConnection rappresenta una connessione univoca a un'origine dati. Quando si crea un'istanza della classe SqlCeConnection tutte le proprietà vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il costruttore della classe SqlCeConnection.

Se la classe SqlCeConnection esula dall'ambito, non viene chiusa. È necessario chiudere esplicitamente la connessione chiamando il metodo Close o Dispose.

SQL Server Compact 3.5 supporta più connessioni simultanee e più comandi che condividono la stessa connessione. È pertanto possibile disporre di più istanze di SqlCeDataReader aperte sulla stessa connessione. Questo comportamento è diverso da quello di System.Data.SqlClient.

Se viene generata un'eccezione SqlCeException irreversibile dal metodo durante l'esecuzione di un comando SqlCeCommand, è possibile che la connessione SqlCeConnection venga chiusa. È possibile riaprire la connessione e continuare.

SQL Server Compact 3.5 non è attualmente ottimizzato per essere utilizzato come 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 Express, 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)

Esempi

Nell'esempio seguente vengono create una classe SqlCeCommand e una classe SqlCeConnection. La classe SqlCeConnection viene aperta e impostata come proprietà Connection per la classe SqlCeCommand. Nell'esempio viene quindi chiamato ExecuteNonQuery e la connessione viene chiusa.

Dim conn As SqlCeConnection = Nothing

Try
    conn = New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')"

    cmd.ExecuteNonQuery()
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')";

    cmd.ExecuteNonQuery();
}
finally
{
    conn.Close();
}