Oggetti origine dei dati OLE DB (SQL Server Compact)

Nella programmazione OLE DB, l'oggetto origine dei dati rappresenta l'archivio dati sottostante del provider. Per stabilire una connessione a un provider OLE DB, un consumer deve innanzitutto creare e inizializzare un'istanza dell'oggetto origine dei dati.

Oggetto origine dei dati di SQL Server Compact

In Microsoft SQL Server Compact 3.5 (SQL Server Compact 3.5), l'oggetto origine dati viene creato chiamando la funzione OLE CoCreateInstance, quindi passando l'identificatore di classe (CLSID) per il provider OLE DB per SQL Server Compact 3.5, ovvero CLSID_SQLSERVERCE. Poiché SQL Server Compact 3.5 è un server in-process, le istanze degli oggetti OLE DB di SQL Server Compact 3.5 vengono create utilizzando la macro CLSCTX_INPROC_SERVER per indicare il contesto eseguibile.

Per specificare l'origine dei dati desiderata, in SQL Server Compact 3.5 viene utilizzata soltanto la proprietà DBPROP_INIT_DATASOURCE, con cui viene passato il percorso completo del file di database da aprire. Dopo l'impostazione di questa proprietà, il consumer inizializza l'oggetto origine dei dati. Viene così stabilito l'ambiente necessario per lo scambio di dati tra consumer e SQL Server Compact 3.5. Al termine dell'inizializzazione dell'oggetto origine dei dati, il consumer può ottenere informazioni autodescrittive sull'archivio dati, ma non può ancora accedere ai dati. Questo oggetto origine dei dati può quindi essere utilizzato per creare uno o più oggetti di sessione, che vengono a propria volta utilizzati per creare le transazioni, i comandi e i set di righe necessari.

Il provider OLE DB per SQL Server Compact 3.5 consente inoltre di creare un nuovo database. Per ulteriori informazioni, vedere Creazione di database con OLE DB.

Sono inoltre supportati database protetti da password. Con questa funzionalità di protezione, al momento dell'inizializzazione dell'oggetto origine dei dati deve essere passata una password. Per ulteriori informazioni, vedere Accesso a database protetti da password con OLE DB.

Limitazioni dell'oggetto origine dei dati

Le limitazioni dell'oggetto origine dei dati del provider OLE DB per SQL Server Compact 3.5 includono quanto segue:

• Il concetto di catalogo definito in OLE DB non viene utilizzato in SQL Server Compact 3.5. La proprietà DBPROP_INIT_DATASOURCE definisce il database da utilizzare e il provider OLE DB per SQL Server Compact 3.5 gestisce questo database come catalogo corrente.
• Non è supportata la possibilità di modificare l'archivio dati corrente. I client che desiderano modificare l'archivio dati devono annullare l'inizializzazione dell'oggetto origine dei dati, impostare il nome del nuovo archivio dati e quindi eseguire nuovamente l'inizializzazione dell'oggetto origine dei dati.

Proprietà dell'origine dei dati specifiche del provider

SQL Server Compact 3.5 supporta le proprietà specifiche del provider descritte di seguito, nel set di proprietà specifiche del provider DBPROPSET_SSCE_DBINIT.

Proprietà	Definizione
DBPROP_SSCE_AUTO_SHRINK_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.
DBPROP_SSCE_DBCASESENSITIVE	Valore booleano che determina se le regole di confronto del database rispettano la distinzione tra maiuscole e minuscole. La proprietà deve essere impostata su true per abilitare le regole di confronto con distinzione tra maiuscole e minuscole. In caso contrario, la proprietà deve essere impostata su false. Se il valore non viene specificato, l'impostazione predefinita è false. Nota: Questa proprietà viene introdotta a partire dalla versione SQL Server Compact 3.5 SP1. Per ulteriori informazioni, vedere Utilizzo delle regole di confronto (SQL Server Compact).
DBPROP_SSCE_DBPASSWORD	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. Per ulteriori informazioni, vedere Accesso a database protetti da password con OLE DB.
DBPROP_SSCE_DEFAULT_LOCK_ESCALATION	Numero dei blocchi che devono essere acquisiti da una transazione prima di tentare l'innalzamento di livello da riga a tabella o da pagina a tabella. Se il valore non viene specificato, l'impostazione predefinita è 100.
DBPROP_SSCE_DEFAULT_LOCK_TIMEOUT	Valore di attesa predefinito, in millisecondi, prima del blocco di una transazione. Se non viene specificato, il valore predefinito è 5000 millisecondi per i computer desktop e 2000 millisecondi per i dispositivi.
DBPROP_SSCE_ENCRYPTDATABASE	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à.
DBPROP_SSCE_ENCRYPTIONMODE	Tipo di crittografia utilizzato per proteggere il file di database. Per ulteriori informazioni sulla modalità di crittografia, vedere la descrizione in Proprietà specifiche del provider (OLE DB).
DBPROP_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.
DBPROP_SSCE_MAXBUFFERSIZE	Dimensione massima del database, in MB. Se il valore non viene specificato, l'impostazione predefinita è 640.
DBPROP_SSCE_MAX_DATABASE_SIZE	Dimensione massima del database, in MB. Se il valore non viene specificato, l'impostazione predefinita è 128.
DBPROP_SSCE_TEMPFILE_DIRECTORY	Percorso del database temporaneo. Se non viene specificato, per impostazione predefinita come database temporaneo verrà utilizzato il database principale specificato nelle proprietà della connessione. Per ulteriori informazioni, vedere Specifica del percorso del database temporaneo tramite OLE DB e Database temporanei.
DBPROP_SSCE_TEMPFILE_MAX_SIZE	Dimensioni massime del database temporaneo, in MB.