Compartir a través de

SqlCeConnection.ConnectionString Property

  • Artículo

Obtiene o establece la cadena que se utiliza para abrir una base de datos.

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

Sintaxis

'Declaración
Public Overrides Property ConnectionString As String

public override string ConnectionString { get; set; }

public:
virtual property String^ ConnectionString {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_ConnectionString ()

/** @property */
public void set_ConnectionString (String value)

public override function get ConnectionString () : String

public override function set ConnectionString (value : String)

Valor de la propiedad

Cadena de conexión del proveedor de datos de .NET Compact Framework para SQL Server Compact 3.5 que incluye el nombre del origen de datos y otros parámetros necesarios para establecer la conexión inicial. El valor predeterminado es una cadena vacía.

Excepciones

Tipo de excepción Condición
ArgumentException

Se ha suministrado un argumento de cadena de conexión no válido.

Notas

La propiedad ConnectionString sólo se puede configurar cuando la conexión está cerrada. Muchos de los valores de cadena de conexión tienen propiedades asociadas de sólo lectura. Cuando se establece la cadena de conexión, se actualizan todas estas propiedades, excepto cuando se detecta un error. En este caso, no se actualiza ninguna de las propiedades. Las propiedades de SqlCeConnection devuelven únicamente los valores contenidos en ConnectionString.

Si se restablece ConnectionString en una conexión cerrada, se restablecen todos los valores de cadena de conexión y sus propiedades relacionadas, incluida la contraseña.

En la tabla siguiente se enumeran las propiedades de ConnectionString compatibles con SQL Server Compact 3.5.

Propiedad

Description

data source o datasource

Ruta de acceso y nombre de la base de datos SQL Server Compact 3.5. Para indicar una ruta de acceso relativa a la base de datos del directorio de aplicaciones, utilice el origen de datos = cadena de sustitución (entre símbolos de canalización) de |DataDirectory|. Utilice el método SetData del objeto AppDomain para establecer el directorio de datos de la aplicación. Los dispositivos no admiten DataDirectory. Para obtener más información, vea Instalar e implementar en un escritorio (SQL Server Compact)".

Password, Pwd, database password o ssce:database password

Contraseña de la base de datos (puede tener hasta 40 caracteres). Si no se especifica, el valor predeterminado es sin contraseña. Esta propiedad es obligatoria si se habilita el cifrado en la base de datos. Si se especifica una contraseña, el cifrado se habilita automáticamente en la base de datos. Si se especifica una contraseña en blanco, la base de datos no se cifrará.

ssce:enlist

o

enlist

El valor predeterminado de enlist es false. Se puede establecer en true. Si se abra una conexión a la base de datos de SQL Server Compact 3.5 mediante Enlist configurado en true, la conexión aumenta de nivel a transacción.

ssce:encryption mode

o

encryption mode

Los valores posibles para la propiedad son

engine default

o

platform default

o

ppc2003 compatibility

El valor predeterminado es platform default.

ew0d66d7.note(es-es,VS.90).gifNota:
Esta propiedad es una opción en el momento de la creación de la base de datos y se omite en la conexión a una base de datos existente.

Encrypt, encrypt database o ssce:encrypt database

Valor booleano que determina si la base de datos está o no cifrada. El valor true habilita el cifrado; el valor false indica ausencia de cifrado. Si no se especifica, el valor predeterminado es false. Si se habilita el cifrado, también se deberá especificar una contraseña mediante la propiedad password. Si se especifica una contraseña, el cifrado se habilita independientemente del valor de esta propiedad.

ew0d66d7.note(es-es,VS.90).gifNota:
Esta propiedad es una opción en el momento de la creación de la base de datos y se omite en la conexión a una base de datos existente. Si se especifica una contraseña SSCE:Database, la base de datos se cifra con independencia de si se ha especificado SSCE:Encrypt Database.

max buffer size o ssce:max buffer size

Cantidad máxima de memoria, en kilobytes, que SQL Server Compact 3.5 puede utilizar antes de comenzar a volcar los cambios en el disco. Si no se especifica, el valor predeterminado es 640.

max database size o ssce:max database size

El tamaño máximo de la base de datos, en Megabytes. Si no se especifica, el valor predeterminado es 128.

Mode, file mode o ssce:mode

El modo que se utiliza al abrir el archivo de base de datos. La tabla siguiente muestra los valores válidos. Si no se especifica, el valor predeterminado es 'Lectura y escritura'.

default lock timeout o ssce:default lock timeout

El número de milisegundos predeterminado que una transacción esperará un bloqueo. Si no se especifica, el valor predeterminado es 2000.

default lock escalation o ssce:default lock escalation

Número de bloqueos que adquirirá una transacción antes de intentar ampliar el bloqueo de una fila a una página o de una página a una tabla. Si no se especifica, el valor predeterminado es 100.

flush interval o ssce:flush interval

Especifica el intervalo de tiempo (en segundos) que debe transcurrir antes de volcar en el disco todas las transacciones confirmadas. Si no se especifica, el valor predeterminado es 10.

autoshrink threshold o ssce:autoshrink threshold

Porcentaje de espacio libre permitido en el archivo de base de datos antes de que se inicie la reducción automática. Un valor de 100 deshabilita la reducción automática. Si no se especifica, el valor predeterminado es 60.

temp path, temp file directory o ssce:temp file directory

Ubicación de la base de datos temporal. Si no se especifica, el comportamiento predeterminado consiste en utilizar la base de datos especificada en la propiedad de origen de datos para el almacenamiento temporal.

tamaño máximo del archivo temporal

El tamaño máximo del archivo de base de datos temporal, en Megabytes. Si no se especifica, el valor predeterminado es 128.

información de seguridad persistente

Cuando esta propiedad se establece en false (lo más recomendable), la información de seguridad, como la contraseña, no se devuelve como parte de la conexión si la conexión está abierta o ha estado alguna vez en este estado. El restablecimiento de la cadena de conexión restablece todos los valores de la cadena de conexión, incluida la contraseña. El valor predeterminado es false.

locale identifier, Lcid o initial lcid

El identificador de configuración regional (LCID) que se utilizará con la base de datos. Los valores válidos del LCID se enumeran en la clase CultureInfo.

ew0d66d7.note(es-es,VS.90).gifNota:
Esta propiedad es una opción en el momento de la creación de la base de datos y se omite en la conexión a una base de datos existente.

Case Sensitive o CaseSensitive

Valor booleano que determina si la intercalación de base de datos distingue mayúsculas de minúsculas o no. Se debe establecer en true para habilitar que la intercalación distinga mayúsculas de minúsculas o en false para habilitar que la intercalación no distinga mayúsculas de minúsculas. Si no se especifica un valor, el valor predeterminado es false. Si se conecta a una base de datos existente de SQL Server Compact con una propiedad "Case Sensitive" en la cadena de conexión, SQL Server Compact 3.5 SP1 omitirá este valor de configuración.

ew0d66d7.note(es-es,VS.90).gifNota:
Esta propiedad es una opción en el momento de la creación de la base de datos y se omite en la conexión a una base de datos existente.

A continuación se muestran los valores válidos de la propiedad mode de la cadena de conexión.

Valor

Definición

Lectura y escritura

Permite a varios procesos abrir y modificar la base de datos. Ésta es la configuración predeterminada si no se especifica la propiedad mode.

De sólo lectura

Permite abrir una copia de sólo lectura de la base de datos.

Exclusivo

No permite a otros procesos abrir o modificar la base de datos.

Lectura compartida

Permite a otros procesos leer, pero no modificar, la base de datos mientras está abierta.

Cuando se establece la propiedad se realiza una validación preliminar de la cadena de conexión. Cuando una aplicación llama al método Open, la cadena de conexión se valida por completo. Si la cadena de conexión contiene propiedades no válidas o no admitidas, en ese momento se genera una excepción en tiempo de ejecución, como ArgumentException.

Las reglas que se aplican a las cadenas de conexión son las siguientes:

  1. Se pasan por alto todos los caracteres en blanco, excepto los que se encuentran dentro de un valor o entre comillas.

  2. Los pares de valores de las contraseñas deben estar separados por un punto y coma (;). Si el punto y coma forma parte del valor, éste también debe estar delimitado por comillas.

  3. No se admiten secuencias de escape.

  4. El tipo de valor carece de importancia.

  5. Los nombres no distinguen mayúsculas y minúsculas.

  6. Si el nombre de una propiedad aparece más de una vez en la cadena de conexión, se utiliza el valor asociado a la última aparición.

  7. Los valores pueden separarse con comillas sencillas o dobles (por ejemplo, nombre='valor' o nombre="valor"). Si desea utilizar las comillas simples dentro de una cadena de conexión, deberá utilizar las comillas dobles como delimitador, o viceversa. Por ejemplo, los siguientes constituyen usos válidos de las comillas dentro de una cadena de conexión:

    "data source='MyDb.sdf'; mode=Exclusive;"
'data source="MyDb.sdf"; mode=Exclusive;'

    Por el contrario, estos ejemplos no son válidos:

    "data source="MyDb.sdf"; mode=Exclusive;"
'data source='MyDb.sdf'; mode=Exclusive;'

Ejemplo

En el ejemplo siguiente se crea una conexión SqlCeConnection y se establecen algunas de sus propiedades en la cadena de conexión.

Dim conn As New SqlCeConnection()

' Set some connection string properties e.g.:
' 
conn.ConnectionString = _
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" & _
    "Password = '<password>'; File Mode = 'shared read'; " & _
    "Max Database Size = 256; Max Buffer Size = 1024"

conn.Open()

' You can change the database while preserving 
' the orignal connection options
'
conn.ChangeDatabase("SupportData.sdf")

SqlCeConnection conn = new SqlCeConnection();

// Set some connection string properties e.g.:
// 
conn.ConnectionString = 
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" +
    "Password = '<password>'; File Mode = 'shared read'; " +
    "Max Database Size = 256; Max Buffer Size = 1024";

conn.Open();

// You can change the database while preserving 
// the orignal connection options
//
conn.ChangeDatabase("SupportData.sdf");

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace

Otros recursos

Actualizar desde versiones anteriores (SQL Server Compact)