SqlCeConnection.ConnectionString Propiedad

Artículo
05/27/2011

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
    Get
    Set
'Uso
Dim instance As SqlCeConnection
Dim value As String

value = instance.ConnectionString

instance.ConnectionString = value

public override string ConnectionString { get; set; }

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

abstract ConnectionString : string with get, set
override ConnectionString : string with get, set

override function get ConnectionString () : String
override function set ConnectionString (value : String)

Valor de la propiedad

Tipo: System.String
Cadena de conexión del proveedor de datos de .NET Compact Framework para SQL Server Compact 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.

Implementa

IDbConnection.ConnectionString

Excepciones

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

Comentarios

La propiedad ConnectionString solo se puede configurar cuando la conexión está cerrada. Muchos de los valores de cadena de conexión tienen propiedades asociadas de solo 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.

Propiedad	Description
data source o datasource	La ruta de acceso y el nombre del archivo de la base de datos de SQL Server Compact. Para indicar una ruta de acceso relativa a la base de datos del directorio de aplicaciones, utilice la cadena de sustitución Origen de datos = \|DataDirectory\| (entre símbolos de canalización). 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 mediante Enlist configurado en true, la conexión aumenta de nivel a transacción.
ssce:encryption mode o encryption mode	Los valores para esta propiedad son predeterminado para motor o predeterminado para plataforma El valor predeterminado es predeterminado para plataforma. Nota 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. Nota 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 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. Nota 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. Nota 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 solo lectura	Permite abrir una copia de solo 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:

Se pasan por alto todos los caracteres en blanco, excepto los que se encuentran dentro de un valor o entre comillas.
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.
No se admiten secuencias de escape.
El tipo de valor carece de importancia.
Los nombres no distinguen mayúsculas y minúsculas.
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.
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;'
```

Ejemplos

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");

Vea también

Referencia

SqlCeConnection Clase

Espacio de nombres System.Data.SqlServerCe

Otros recursos

Actualizar desde versiones anteriores (SQL Server Compact)

Compartir a través de