Proprietà LocalConnectionString (RDA)
La proprietà LocalConnectionString specifica la stringa di connessione OLE DB per il database di SQL Server Compact 3.5 nel dispositivo basato su Microsoft Windows CE.
Sintassi
object.LocalConnectionString(value)
Si applica a
Oggetto RDA di SQL Server Compact 3.5
Tipo di dati
String
Modificabilità
Lettura/scrittura
Prototipo
HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);
Parametri generici
Parametro |
Descrizione |
|---|---|
value |
Stringa di connessione OLE DB per il database di SQL Server Compact 3.5. |
Osservazioni
Nella tabella seguente vengono elencati i nomi di proprietà disponibili per la stringa di connessione OLE DB.
Proprietà |
Descrizione |
|---|---|
data source |
Percorso e nome file del database di SQL Server Compact 3.5. Specificare il percorso assoluto del file di database, anziché un percorso relativo. .gif "Nota") Nota
Un'applicazione in esecuzione in un computer desktop non può aprire una connessione al database in un file con estensione sdf in un dispositivo. Analogamente, un'applicazione in esecuzione in un dispositivo non può aprire una connessione al database in un file con estensione sdf in un computer desktop.
|
ssce: database password |
Password del database, costituita da un massimo di 40 caratteri. Se non viene specificata, l'impostazione predefinita è nessuna password. Questa proprietà è obbligatoria se si abilita la crittografia sul database. Se si specifica una password, sul database verrà abilitata la crittografia. Se si specifica una password vuota, il database non verrà crittografato. |
ssce: encrypt database |
Valore Boolean che determina se il database è crittografato. Per abilitare la crittografia, tale valore deve essere impostato su true. In caso contrario, deve essere impostato su false. Se il valore non viene specificato, l'impostazione predefinita è false. Se si abilita la crittografia, è necessario specificare anche una password con la proprietà password. Se si specifica una password, la crittografia verrà abilitata indipendentemente dalla modalità di impostazione di questa proprietà. Se si specifica una password, inoltre, il database viene crittografato indipendentemente dalla specifica o meno di SSCE:Encrypt Database. Nota
La proprietà encrypt non verrà supportata nelle versioni future, ma viene mantenuta in SQL Server Compact 3.5 per compatibilità con le versioni precedenti.
|
ssce:encryption mode oppure encryption mode |
I valori per questa proprietà sono engine default, platform default o ppc2003 compatibility.Il valore predefinito è platform default. |
ssce: max buffer size |
Quantità massima di memoria, in KB, utilizzabile da SQL Server Compact 3.5 prima che venga avviato lo scaricamento delle modifiche su disco. Se il valore non viene specificato, l'impostazione predefinita è 640. |
ssce: max database size |
Dimensione massima del database, in MB. Se il valore non viene specificato, l'impostazione predefinita è 128. |
ssce:mode |
Modalità da utilizzare all'apertura del file di database. Per i valori validi, vedere la tabella riportata di seguito. Se il valore non viene specificato, l'impostazione predefinita è lettura/scrittura. |
ssce: default lock timeout |
Valore di attesa predefinito, in millisecondi, prima del blocco di una transazione. Se il valore non viene specificato, l'impostazione predefinita è 2000. |
ssce: default lock escalation |
Numero dei blocchi che devono essere acquisiti da una transazione prima di tentare l'innalzamento di livello da riga a pagina o da pagina a tabella. Se il valore non viene specificato, l'impostazione predefinita è 100. |
ssce: flush interval |
Specifica l'intervallo di tempo, in secondi, prima che le transazioni di cui è stato eseguito il commit vengano scaricate su disco. Se il valore non viene specificato, l'impostazione predefinita è 10. |
ssce: autoshrink threshold |
Percentuale di spazio disponibile consentito nel file di database prima che venga abilitata la compattazione automatica. Impostando il valore 100 verrà disabilitata la compattazione automatica. Se il valore non viene specificato, l'impostazione predefinita è 60. |
ssce: temp file directory |
Percorso del database temporaneo. Se non viene specificato, per impostazione predefinita verrà utilizzato il database specificato nella proprietà dell'origine dati relativa all'archiviazione temporanea. |
ssce: temp file max size |
Dimensioni massime del file del database temporaneo, in MB. Se il valore non viene specificato, l'impostazione predefinita è 128. |
locale identifier |
ID delle impostazioni locali (LCID) da utilizzare con il database. |
ssce:case sensitive |
Valore booleano che determina se al database viene applicata la distinzione tra maiuscole e minuscole. Per abilitare la distinzione tra maiuscole e minuscole, tale valore deve essere impostato su true. In caso contrario, deve essere impostato su false. Se il valore non viene specificato, l'impostazione predefinita è false. Nota
Questa proprietà di connessione è stata introdotta in SQL Server Compact 3.5 SP1.
|
Nella tabella seguente sono riportati i valori validi per la proprietà mode della stringa di connessione.
Valore |
Definizione |
|---|---|
Lettura/scrittura |
Consente a più processi di aprire e modificare il database. Si tratta dell'impostazione predefinita se non viene specificata la proprietà relativa alla modalità. |
Sola lettura |
Consente di aprire una copia in sola lettura del database. |
Exclusive |
Non consente ad altri processi di aprire o modificare il database. |
Shared Read |
Consente ad altri processi di leggere il database aperto, ma non di apportarvi modifiche. |
Alle stringhe di connessione vengono applicate le regole seguenti:
Tutti gli spazi vuoti, ad eccezione di quelli all'interno di un valore o tra virgolette, vengono ignorati.
Le coppie parola chiave-valore devono essere separate da un punto e virgola (;). Se un punto e virgola è parte di un valore, è necessario delimitarlo da virgolette.
Non sono supportate sequenze di escape.
Il tipo di valore è irrilevante.
Ai nomi non viene applicata la distinzione tra maiuscole e minuscole.
Se il nome di una proprietà ricorre più volte nella stringa di connessione, viene utilizzato il valore associato all'ultima occorrenza.
I valori possono essere delimitati da virgolette singole o doppie, ad esempio nome='valore' o nome="valore". All'interno di una stringa di connessione possono essere utilizzate virgolette singole o doppie in combinazione con l'altro delimitatore. Di seguito, ad esempio, vengono illustrati utilizzi validi delle virgolette all'interno di una stringa di connessione:
"data source='MyDb.sdf'; ssce: mode=Exclusive;" 'data source="MyDb.sdf"; ssce: mode=Exclusive;'- Questi esempi invece non sono validi:
"data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'