Classe SqlCeConnection

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

Gerarchia di ereditarietà

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

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

Nel tipo SqlCeConnection sono esposti i membri seguenti.

Costruttori

	Nome	Descrizione
	SqlCeConnection()	Inizializza una nuova istanza della classe SqlCeConnection.
	SqlCeConnection(String)	Inizializza una nuova istanza della classe SqlCeConnection con la stringa di connessione specificata.

In alto

Proprietà

	Nome	Descrizione
	CanRaiseEvents	(ereditato da Component)
	ConnectionString	Ottiene o imposta la stringa utilizzata per aprire un database. Esegue l'override di DbConnection.ConnectionString.
	ConnectionTimeout	Ottiene il tempo di attesa durante il quale si tenta di stabilire una connessione, prima di terminare il tentativo e generare un errore. Esegue l'override di DbConnection.ConnectionTimeout.
	Container	(ereditato da Component)
	Database	Ottiene il nome del database corrente o del database da utilizzare quando viene aperta una connessione. Esegue l'override di DbConnection.Database.
	DatabaseIdentifier	Ottiene l'identificatore univoco del database corrente durante la sincronizzazione.
	DataSource	Ottiene il nome file dell'origine dati. Esegue l'override di DbConnection.DataSource.
	DbProviderFactory	(ereditato da DbConnection)
	DesignMode	(ereditato da Component)
	Events	(ereditato da Component)
	ServerVersion	Restituisce il numero di versione del database in forma di stringa. Esegue l'override di DbConnection.ServerVersion.
	Site	(ereditato da Component)
	State	Ottiene lo stato corrente della connessione. Esegue l'override di DbConnection.State.

In alto

Metodi

	Nome	Descrizione
	BeginDbTransaction	(ereditato da DbConnection)
	BeginTransaction()	Avvia una transazione di database.
	BeginTransaction(IsolationLevel)	Avvia una transazione di database con il valore IsolationLevel corrente.
	ChangeDatabase	Modifica il database corrente per un oggetto SqlCeConnection aperto. Esegue l'override di DbConnection.ChangeDatabase(String).
	Close	Chiude la connessione all'origine dati. Questo è il metodo consigliato per chiudere qualsiasi connessione aperta. Esegue l'override di DbConnection.Close().
	CreateCommand	Crea e restituisce un oggetto SqlCeCommand associato all'oggetto SqlCeConnection.
	CreateDbCommand	(ereditato da DbConnection)
	CreateObjRef	(ereditato da MarshalByRefObject)
	Dispose()	Rilascia tutte le risorse utilizzate dall'istanza corrente della classe SqlCeConnection.
	Dispose(Boolean)	(ereditato da Component)
	EnlistTransaction(Transaction)	(ereditato da DbConnection)
	EnlistTransaction(Transaction)	Esegue l'integrazione nell'oggetto Transaction specificato.
	Equals	(ereditato da Object)
	Finalize	(ereditato da Component)
	GetDatabaseInfo	Restituisce un set di coppie chiave/valore con informazioni sulle impostazioni locali, sulla modalità di crittografia e sull'impostazione relativa alla distinzione tra maiuscole e minuscole del database connesso.
	GetHashCode	(ereditato da Object)
	GetLifetimeService	(ereditato da MarshalByRefObject)
	GetSchema()	Restituisce le informazioni sullo schema per l'origine dati di questo oggetto SqlCeConnection. Esegue l'override di DbConnection.GetSchema().
	GetSchema(String)	Restituisce le informazioni sullo schema per l'origine dati di questo oggetto SqlCeConnection utilizzando la stringa specificata per il nome dello schema. Esegue l'override di DbConnection.GetSchema(String).
	GetSchema(String, array<String[])	Restituisce le informazioni sullo schema per l'origine dati di questo oggetto SqlCeConnection utilizzando la stringa specificata per il nome dello schema e la matrice di stringa specificata per i valori delle restrizioni. Esegue l'override di DbConnection.GetSchema(String, array<String[]).
	GetService	(ereditato da Component)
	GetType	(ereditato da Object)
	InitializeLifetimeService	(ereditato da MarshalByRefObject)
	MemberwiseClone()	(ereditato da Object)
	MemberwiseClone(Boolean)	(ereditato da MarshalByRefObject)
	OnStateChange	(ereditato da DbConnection)
	Open	Apre una connessione a un database con le impostazioni delle proprietà specificate dalla proprietà ConnectionString. Esegue l'override di DbConnection.Open().
	ToString	(ereditato da Component)

In alto

Eventi

	Nome	Descrizione
	Disposed	(ereditato da Component)
	FlushFailure	Si verifica quando lo svuotamento in background ha esito negativo.
	InfoMessage	Evento generato quando il provider di dati .NET Compact Framework per SQL Server invia un avviso o un messaggio informativo.
	StateChange	Viene generato quando lo stato della connessione cambia. Esegue l'override di DbConnection.StateChange.

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IDbConnection.BeginTransaction()	(ereditato da DbConnection)
	IDbConnection.BeginTransaction(IsolationLevel)	(ereditato da DbConnection)
	IDbConnection.CreateCommand	(ereditato da DbConnection)

In alto

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 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.

Esempi

Nell'esempio seguente vengono create un oggetto SqlCeCommand e un oggetto SqlCeConnection. L'oggetto SqlCeConnection viene aperto e impostato come proprietà Connection per l'oggetto 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();
}

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

SqlCeDataAdapter

SqlCeCommand