Compartir a través de


Propiedad LocalConnectionString (SQL Server Compact Edition)

Proporciona la cadena de conexión para la base de datos local de Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition).

Sintaxis

object.LocalConnectionString

Propiedades

Parte Descripción

Object

Un objeto Engine de SQL Server Compact Edition

Modificable

Sólo lectura

Notas

El valor de la propiedad LocalConnectionString sólo puede establecerse si la conexión está cerrada. Muchos de los valores de la cadena de conexión tienen propiedades correspondientes de sólo lectura. Cuando se establece la cadena de conexión, se actualizan todas estas propiedades, excepto si se detecta un error. En ese caso, las propiedades no se actualizan.

Al restablecer LocalConnectionString en una conexión cerrada, se restablecen todos los valores de la cadena de conexión y las propiedades relacionadas, incluida la contraseña.

En la tabla siguiente se enumeran las propiedades de LocalConnectionString que se admiten en SQL Server Compact Edition.

Propiedad

Descripción

data source

Ruta de acceso y nombre de archivo de la base de datos de SQL Server Compact Edition.

[!NOTA] Debe especificar la ruta de acceso absoluta del archivo de base de datos, en lugar de una ruta relativa.

ssce: database password

Contraseña de la base de datos, cuya longitud máxima es de 40 caracteres. Si no se especifica ningún valor, de forma predeterminada no se utiliza ninguna contraseña. Esta propiedad debe especificarse si se habilita el cifrado en la base de datos. Si se especifica una contraseña, se habilita el cifrado en la base de datos.

ssce: encrypt database

Valor booleano que determina si la base de datos está cifrada. Debe establecerse en true para habilitar el cifrado o en false para deshabilitarlo. Si no se especifica ningún valor, de forma predeterminada el valor es false. Si se habilita el cifrado, se debe especificar también una contraseña mediante la propiedad correspondiente. Si se especifica una contraseña, el cifrado se habilita independientemente del valor establecido para esta propiedad.

ssce: max buffer size

Cantidad máxima de memoria (en KB) que puede usar SQL Server Compact Edition antes de empezar a vaciar los cambios en el disco. Si no se especifica ningún valor, se utiliza el valor predeterminado 640.

ssce: max database size

Tamaño máximo de la base de datos, en MB. Si no se especifica ningún valor, se utiliza el valor predeterminado 128.

ssce:mode

Modo que se usa al abrir el archivo de base de datos. En la tabla mostrada a continuación se indican los valores válidos. Si no se especifica ningún valor, se utiliza el valor predeterminado de lectura y escritura.

ssce: default lock timeout

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

ssce: default lock escalation

Número de bloqueos que adquirirá una transacción antes de que se intente efectuar una extensión de fila a página o de página a tabla. Si no se especifica ningún valor, se utiliza el valor predeterminado 100.

ssce: flush interval

Especifica el intervalo de tiempo en segundos antes de que todas las transacciones confirmadas se vacíen en el disco. Si no se especifica ningún valor, se utiliza el valor predeterminado 10.

ssce: autoshrink threshold

Porcentaje de espacio libre en el archivo de base de datos permitido antes del inicio de la reducción automática. Un valor de 100 deshabilita la reducción automática. Si no se especifica ningún valor, se utiliza el valor predeterminado 60.

ssce: temp file directory

Ubicación de la base de datos temporal. Si no se especifica, el valor predeterminado es utilizar como almacenamiento temporal la base de datos especificada en la propiedad de origen de datos.

ssce: temp file max size

Tamaño máximo del archivo de base de datos temporal, en megabytes. Si no se especifica ningún valor, se utiliza el valor predeterminado 128.

locale identifier

Identificador de configuración regional (LCID) que se debe utilizar con la base de datos.

En la tabla siguiente se muestran los valores válidos de la propiedad de modo de la cadena de conexión.

Valor

Definición

Lectura y escritura

Permite que varios procesos abran y modifiquen la base de datos. Se trata del valor predeterminado si no se especifica la propiedad de modo.

Sólo lectura

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

Exclusivo

No permite que otros procesos abran o modifiquen la base de datos.

Lectura compartida

Permite que otros procesos lean la base datos mientras está abierta, pero no permite que la modifiquen.

Las cadenas de conexión siguen estas reglas:

  1. Todos los caracteres de espacio en blanco, excepto los que se encuentran dentro de un valor o entre comillas, se omiten.

  2. Los pares de valores de palabras clave deben separarse mediante punto y coma (;). Si un punto y coma forma parte de un valor, deberá delimitarse entre comillas tipográficas.

  3. No se admiten secuencias de escape.

  4. El tipo del valor no es relevante.

  5. En los nombres no se distinguen mayúsculas y minúsculas.

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

  7. Los valores pueden delimitarse mediante comillas tipográficas sencillas o dobles; por ejemplo, nombre='valor' o nombre="valor". Se pueden utilizar tanto comillas tipográficas sencillas como dobles dentro de una cadena de conexión si se utiliza como delimitador la otra opción. Por ejemplo, los siguientes usos son válidos dentro de una cadena de conexión:

    "data source='MyDb.sdf'; ssce: mode=Exclusive;"
    'data source="MyDb.sdf"; ssce: mode=Exclusive;'
    But these examples are not valid:
    "data source="MyDb.sdf"; ssce: mode=Exclusive;"
    'data source='MyDb.sdf'; ssce: mode=Exclusive;'
    

Vea también

Referencia

Objeto SSCEError
Método CompactDatabase (SQL Server Compact Edition)
Colección SSCEErrors

Ayuda e información

Obtener ayuda sobre SQL Server Compact Edition