Propriedade LocalConnectionString (RDA)
A propriedade LocalConnectionString especifica a cadeia de conexão OLE DB para o banco de dados do SQL Server Compact 3.5 (SQL Server Compact 3.5) no dispositivo baseado em Microsoft Windows CE.
Sintaxe
object.LocalConnectionString(value)
Aplica-se a
Objeto RDA do SQL Server Compact 3.5
Tipo de dados
String
Modificável
Leitura/gravação
Protótipo
HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);
Parâmetros genéricos
| Parâmetro | Descrição |
|---|---|
value |
A cadeia de conexão OLE DB para o banco de dados do SQL Server Compact 3.5. |
Comentários
A tabela a seguir mostra os nomes de propriedade disponíveis para a cadeia de conexão OLE DB.
| Propriedade | Descrição |
|---|---|
data source |
O caminho do arquivo e o nome do banco de dados do SQL Server Compact 3.5. Especifique o caminho absoluto do arquivo de banco de dados, em vez de um caminho relativo. .gif "ms173248.note(pt-br,SQL.100).gif") Observação:
Um aplicativo executado em um computador desktop não pode abrir uma conexão de banco de dados com um arquivo .sdf em um dispositivo. Da mesma maneira, um aplicativo executado em um dispositivo não pode abrir uma conexão de banco de dados com um arquivo .sdf em um computador desktop.
|
ssce: database password |
A senha do banco de dados, que pode ter até 40 caracteres de comprimento. Se não for especificada, o valor padrão será sem senha. Esta propriedade será necessária se você habilitar a criptografia no banco de dados. Se você especificar uma senha, a criptografia será habilitada no banco de dados. Se você fornecer uma senha em branco, o banco de dados não será criptografado. |
ssce: encrypt database |
Um valor Boolean que determina se o banco de dados é criptografado. Deve ser definido como true para habilitar a criptografia ou false para desabilitá-la. Se não for especificado, o valor padrão será false. Se você habilitar a criptografia, especifique também uma senha com a propriedade password. Se você especificar uma senha, a criptografia será habilitada independentemente de como a propriedade for definida. Se uma senha for especificada, o banco de dados será criptografado independentemente de SSCE:Encrypt Database estar especificado ou não. Observação:
A propriedade encrypt será preterida em uma versão futura. A propriedade é mantida no SQL Server Compact 3.5 para compatibilidade com versões anteriores.
|
ssce:encryption mode ou encryption mode |
Os valores desta propriedade são engine default, platform default ou ppc2003 compatibility. O padrão é platform default. |
ssce: max buffer size |
A maior quantidade de memória, em KB, que o SQL Server Compact 3.5 pode usar antes de começar a liberar alterações para o disco. Se não for especificado, o valor padrão será 640. |
ssce: max database size |
O tamanho máximo do banco de dados, em MB. Se não for especificado, o valor padrão será 128. |
ssce:mode |
O modo a ser usado quando você abrir o arquivo de banco de dados. Para obter os valores válidos, consulte a tabela a seguir. Se não for especificado, o valor padrão será Read/Write. |
ssce: default lock timeout |
O número padrão de milissegundos que uma transação aguardará por um bloqueio. Se não for especificado, o valor padrão será 2000. |
ssce: default lock escalation |
O número de bloqueios que uma transação adquirirá antes de você tentar o escalonamento de linha para página ou de página para tabela. Se não for especificado, o valor padrão será 100. |
ssce: flush interval |
Especifica o intervalo em segundos antes que todas as transações confirmadas sejam liberadas para o disco. Se não for especificado, o valor padrão será 10. |
ssce: autoshrink threshold |
A porcentagem de espaço livre permitido no arquivo de banco de dados antes de iniciar a redução automática. O valor 100 desabilita a redução automática. Se não for especificado, o valor padrão será 60. |
ssce: temp file directory |
O local do banco de dados temporário. Se não for especificado, o padrão será usar o banco de dados especificado na propriedade data source para o armazenamento temporário. |
ssce: temp file max size |
O tamanho máximo do arquivo de banco de dados temporário, em MB. Se não for especificado, o valor padrão será 128. |
locale identifier |
A LCID (identificação de localidade) a ser usada com o banco de dados. |
ssce:case sensitive |
Um valor booleano que determina se o banco de dados diferencia maiúsculas de minúsculas. Deve ser definido como true para habilitar a diferenciação de maiúsculas e minúsculas ou false para desabilitá-la. Se não for especificado, o valor padrão será false. Observação:
Essa propriedade de conexão foi introduzida no SQL Server Compact 3.5 SP1.
|
A tabela a seguir mostra os valores válidos da propriedade mode da cadeia de conexão.
| Valor | Definição |
|---|---|
Read Write |
Permite que vários processos abram e modifiquem o banco de dados. Esta será a configuração padrão se a propriedade mode não for especificada. |
Read Only |
Permite abrir uma cópia somente leitura do banco de dados. |
Exclusive |
Não permite que outros processos abram ou modifiquem o banco de dados. |
Shared Read |
Permite que outros processos leiam, mas não modifiquem, o banco de dados enquanto ele está aberto. |
As seguintes regras se aplicam às cadeias de conexão:
Todos os caracteres em branco, exceto aqueles colocados em um valor ou entre aspas, são ignorados.
Os pares de valores de palavras-chave devem ser separados por ponto-e-vírgula (;). Se um ponto-e-vírgula fizer parte de um valor, ele também deverá estar entre aspas.
Não há suporte para seqüências de escape.
O tipo de valor é irrelevante.
Os nomes não diferenciam maiúsculas de minúsculas.
Se o nome de uma propriedade ocorrer mais de uma vez na cadeia de conexão, será usado o valor associado à última ocorrência.
Os valores podem ser delimitados por aspas simples ou duplas, por exemplo, name='valor' ou name="valor". Aspas simples ou duplas podem ser usadas em uma cadeia de conexão com outro delimitador. Exemplos de usos válidos das aspas em um cadeia de conexão:
"data source='MyDb.sdf'; ssce: mode=Exclusive;" 'data source="MyDb.sdf"; ssce: mode=Exclusive;'- Mas estes exemplos não são válidos:
"data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'