Condividi tramite


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.

[!NOTA] È consigliabile specificare il percorso assoluto del file di database, anziché un percorso relativo.

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:

  1. Tutti gli spazi vuoti, ad eccezione di quelli all'interno di un valore o tra virgolette, vengono ignorati.

  2. 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.

  3. Non sono supportate sequenze di escape.

  4. Il tipo di valore è irrilevante.

  5. Ai nomi non viene applicata la distinzione tra maiuscole e minuscole.

  6. Se il nome di una proprietà ricorre più volte nella stringa di connessione, viene utilizzato il valore associato all'ultima occorrenza.

  7. 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

Guida in linea e informazioni

Assistenza su SQL Server Compact Edition