Clase SqlCeConnection

Representa una conexión abierta a un origen de datos de SQL Server Compact.

Jerarquía de herencia

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

Espacio de nombres:  System.Data.SqlServerCe
Ensamblado:  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
'Uso
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

El tipo SqlCeConnection expone los siguientes miembros.

Constructores

	Nombre	Descripción
	SqlCeConnection()	Inicializa una nueva instancia de la clase SqlCeConnection.
	SqlCeConnection(String)	Inicializa una nueva instancia de la clase SqlCeConnection con la cadena de conexión especificada.

Arriba

Propiedades

	Nombre	Descripción
	CanRaiseEvents	(se hereda de Component)
	ConnectionString	Obtiene o establece la cadena que se utiliza para abrir una base de datos. (Invalida DbConnection.ConnectionString.)
	ConnectionTimeout	Obtiene el tiempo de espera para intentar establecer una conexión antes de detenerse y generar un error. (Invalida DbConnection.ConnectionTimeout.)
	Container	(se hereda de Component)
	Database	Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar cuando se abra una conexión. (Invalida DbConnection.Database.)
	DatabaseIdentifier	Obtiene el identificador único de la base de datos actual mientras se sincroniza.
	DataSource	Obtiene el nombre de archivo del origen de datos. (Invalida DbConnection.DataSource.)
	DbProviderFactory	(se hereda de DbConnection)
	DesignMode	(se hereda de Component)
	Events	(se hereda de Component)
	ServerVersion	Devuelve el número de versión de la base de datos como cadena. (Invalida DbConnection.ServerVersion.)
	Site	(se hereda de Component)
	State	Obtiene el estado actual de la conexión. (Invalida DbConnection.State.)

Arriba

Métodos

	Nombre	Descripción
	BeginDbTransaction	(se hereda de DbConnection)
	BeginTransaction()	Inicia una transacción de base de datos.
	BeginTransaction(IsolationLevel)	Inicia una transacción de base de datos con el valor IsolationLevel actual.
	ChangeDatabase	Cambia la base de datos actual de una conexión SqlCeConnection abierta. (Invalida DbConnection.ChangeDatabase(String).)
	Close	Cierra la conexión al origen de datos. Éste es el método recomendado para cerrar conexiones abiertas. (Invalida DbConnection.Close().)
	CreateCommand	Crea y devuelve un objeto SqlCeCommand asociado a la conexión SqlCeConnection.
	CreateDbCommand	(se hereda de DbConnection)
	CreateObjRef	(se hereda de MarshalByRefObject)
	Dispose()	Libera todos los recursos utilizados por la instancia actual de la clase SqlCeConnection.
	Dispose(Boolean)	(se hereda de Component)
	EnlistTransaction(Transaction)	(se hereda de DbConnection)
	EnlistTransaction(Transaction)	Da de alta en la clase Transaction especificada.
	Equals	(se hereda de Object)
	Finalize	(se hereda de Component)
	GetDatabaseInfo	Devuelve un conjunto de pares de clave y valor con información sobre la configuración regional, el modo de cifrado y la configuración de distinción entre mayúsculas y minúsculas de la base de datos conectada.
	GetHashCode	(se hereda de Object)
	GetLifetimeService	(se hereda de MarshalByRefObject)
	GetSchema()	Devuelve información de esquema para el origen de datos de este objeto SqlCeConnection. (Invalida DbConnection.GetSchema().)
	GetSchema(String)	Devuelve información de esquema para el origen de datos de este objeto SqlCeConnection utilizando la cadena especificada para el nombre de esquema. (Invalida DbConnection.GetSchema(String).)
	GetSchema(String, array<String[])	Devuelve información de esquema para el origen de datos de este objeto SqlCeConnection utilizando la cadena especificada para el nombre de esquema y la matriz de cadena especificada para los valores de restricción. (Invalida DbConnection.GetSchema(String, array<String[]).)
	GetService	(se hereda de Component)
	GetType	(se hereda de Object)
	InitializeLifetimeService	(se hereda de MarshalByRefObject)
	MemberwiseClone()	(se hereda de Object)
	MemberwiseClone(Boolean)	(se hereda de MarshalByRefObject)
	OnStateChange	(se hereda de DbConnection)
	Open	Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString. (Invalida DbConnection.Open().)
	ToString	(se hereda de Component)

Arriba

Eventos

	Nombre	Descripción
	Disposed	(se hereda de Component)
	FlushFailure	Aparece cuando se produce un error en la tarea de volcado en segundo plano.
	InfoMessage	Se produce cuando el proveedor de datos de .NET Compact Framework para SQL Server envía un mensaje de advertencia o de información.
	StateChange	Se produce cuando el estado de la conexión cambia. (Invalida DbConnection.StateChange.)

Arriba

Implementaciones de interfaces explícitas

	Nombre	Descripción
	IDbConnection.BeginTransaction()	(se hereda de DbConnection)
	IDbConnection.BeginTransaction(IsolationLevel)	(se hereda de DbConnection)
	IDbConnection.CreateCommand	(se hereda de DbConnection)

Arriba

Comentarios

Objeto SqlCeConnection que representa una conexión exclusiva a un origen de datos. Cuando se crea una instancia de SqlCeConnection, se establecen todas las propiedades en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor de SqlCeConnection.

Si la conexión SqlCeConnection está fuera de ámbito, no se cierra. Debe cerrar la conexión de forma explícita mediante una llamada a Close o a Dispose.

SQL Server Compact admite varias conexiones simultáneas, así como varios comandos que compartan la misma conexión. Esto significa que puede tener varias instancias de SqlCeDataReader abiertas en la misma conexión. Este comportamiento difiere del de System.Data.SqlClient.

Si el método que ejecuta SqlCeCommand genera una SqlCeException grave, SqlCeConnection podría cerrarse. El usuario puede volver a abrir la conexión y continuar.

Ejemplos

En el siguiente ejemplo se crean un objeto SqlCeCommand y un objeto SqlCeConnection. El objeto SqlCeConnection se abre y se establece como Connection para SqlCeCommand. A continuación, en el ejemplo se llama a ExecuteNonQuery y se cierra la conexión.

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

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared in Microsoft Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres System.Data.SqlServerCe

SqlCeDataAdapter

SqlCeCommand