SqlCeConnection Class

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

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

public final class SqlCeConnection extends DbConnection

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 connessioneSqlCeConnection 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)

Gerarchia di ereditarietà

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.SqlServerCe.SqlCeConnection

Esempio

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();
}

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

SqlCeConnection Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeCommand Class