Propiedad LocalConnectionString (RDA)
La propiedad LocalConnectionString especifica la cadena de conexión de OLE DB para la base de datos de SQL Server Compact 3.5 en el dispositivo basado en Microsoft Windows CE.
Sintaxis
object.LocalConnectionString(value)
Se aplica a
Objeto RDA de SQL Server Compact 3.5
Tipo de datos
String
Modificable
Lectura/escritura
Prototipo
HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);
Parámetros genéricos
Parámetro |
Descripción |
|---|---|
value |
Cadena de conexión de OLE DB para la base de datos de SQL Server Compact 3.5. |
Notas
La tabla siguiente muestra los nombres de propiedad disponibles para la cadena de conexión OLE DB.
Propiedad |
Descripción |
|---|---|
data source |
Ruta de acceso y nombre de la base de datos de SQL Server Compact 3.5. Especifique la ruta de acceso absoluta del archivo de base de datos, en lugar de una ruta relativa. Nota Una aplicación que se ejecuta en un equipo de escritorio no puede abrir una conexión de base de datos a un archivo .sdf de un dispositivo. Del mismo modo, una aplicación que se ejecuta en un dispositivo no puede abrir una conexión de base de datos a un archivo .sdf de un equipo de escritorio. |
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 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. Si se especifica una contraseña en blanco, la base de datos no se cifra. |
ssce: encrypt database |
Valor A Boolean que determina si la base de datos está 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. Si se especifica una contraseña, la base de datos se cifra con independencia de si se ha especificado SSCE:Encrypt Database. Nota La propiedad encrypt quedará obsoleta en próximas versiones. La propiedad se conserva en SQL Server Compact 3.5 por razones de compatibilidad con las versiones anteriores. |
ssce:encryption mode o encryption mode |
Los valores de esta propiedad son engine default, platform default o ppc2003 compatibility.El valor predeterminado es platform default. |
ssce: max buffer size |
Cantidad máxima de memoria (en KB) que puede usar SQL Server Compact 3.5 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, el valor predeterminado es 10. |
ssce: autoshrink threshold |
Porcentaje de espacio disponible 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 comportamiento predeterminado consiste en utilizar la base de datos especificada en la propiedad de origen de datos para el almacenamiento temporal. |
ssce: temp file max size |
Tamaño máximo del archivo de base de datos temporal en MB. Si no se especifica, el valor predeterminado es 128. |
locale identifier |
El identificador de configuración regional (LCID) que se utilizará con la base de datos. |
ssce:case sensitive |
Valor booleano que determina si la base de datos distingue mayúsculas de minúsculas. Debe establecerse en true para habilitar la distinción de mayúsculas y minúsculas, o en false para deshabilitarla. Si no se especifica, el valor predeterminado es false. .gif "Nota") Nota
Esta propiedad de conexión se incluyó en SQL Server Compact 3.5 SP1.
|
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 que varios procesos abran y modifiquen la base de datos. Se trata del valor predeterminado si no se especifica la propiedad de modo. |
De solo lectura |
Permite abrir una copia de la base de datos en modo de solo 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:
Todos los caracteres de espacio en blanco, excepto los que se encuentran dentro de un valor o entre comillas, se omiten.
Los pares de valores de palabras clave deben separarse mediante 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.
En los nombres no se distinguen mayúsculas y minúsculas.
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.
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 constituyen usos válidos de las comillas dentro de una cadena de conexión:
"data source='MyDb.sdf'; ssce: mode=Exclusive;" 'data source="MyDb.sdf"; ssce: mode=Exclusive;'- Por el contrario, estos ejemplos no son válidos:
"data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'