Proprietà LocalConnectionString (SQL Server Compact Edition)
Specifica la stringa di connessione per il database locale di Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition).
Sintassi
object.LocalConnectionString
Proprietà
Parte | Descrizione |
---|---|
Object |
Oggetto Engine di SQL Server Compact Edition |
Modificabilità
Sola lettura
Osservazioni
La proprietà LocalConnectionString può essere impostata solo quando la connessione è chiusa. A numerosi valori della stringa di connessione corrispondono proprietà di sola lettura. Quando la stringa di connessione viene impostata, tutte queste proprietà vengono aggiornate, tranne in caso di rilevamento di un errore. In questo caso, nessuna proprietà verrà aggiornata.
Reimpostando LocalConnectionString per una connessione chiusa vengono reimpostati tutti i valori della stringa di connessione e le proprietà correlate, inclusa la password.
Nella tabella seguente vengono elencate le proprietà LocalConnectionString supportate in SQL Server Compact Edition.
Proprietà |
Descrizione |
data source |
Nome e percorso di file del database di SQL Server Compact Edition.
|
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 attiva la crittografia sul database. Se si specifica una password, verrà attivata la crittografia sul database. |
ssce: encrypt database |
Valore booleano che determina se il database è crittografato. Deve essere impostato su True per attivare la crittografia, su False per disattivarla. Se il valore non viene specificato, l'impostazione predefinita è False. Se si attiva la crittografia, è necessario specificare anche una password con la proprietà Password. Se si specifica una password, la crittografia verrà attivata indipendentemente dalla modalità di impostazione di questa proprietà. |
ssce: max buffer size |
Quantità massima di memoria, in KB, utilizzabile da SQL Server Compact Edition 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 è "Read Write". |
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 attivata la compattazione automatica. Impostando il valore 100 verrà disattivata 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à data source relativa all'archivio temporaneo. |
ssce: temp file max size |
Dimensioni massime del file di database temporaneo, in MB. Se il valore non viene specificato, l'impostazione predefinita è 128. |
locale identifier |
ID delle impostazioni internazionali (LCID) da utilizzare con il database. |
Nella tabella seguente vengono illustrati i valori validi per la proprietà relativa alla modalità della stringa di connessione.
Valore |
Definizione |
Read Write |
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 (;). I punti e virgola appartenenti a un valore devono essere delimitati 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;' But these examples are not valid: "data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'
Vedere anche
Riferimenti
Oggetto SSCEError
Metodo CompactDatabase (SQL Server Compact)
Insieme SSCEErrors