ISSCEEngine.UpgradeDatabase (SQL Server Compact)

Il metodo ISSCEEngine.Upgrade esegue l'aggiornamento di un database di SQL Server Compact 3.5 dalla versione 3.1 alla versione 3.5. Se il database di origine viene crittografato, anche il database aggiornato verrà crittografato. Il database aggiornato non verrà crittografato solo se viene fornita esplicitamente una password nella stringa di destinazione.

Sintassi

object.UpgradeDatabase(SourceConnection, DestConnection)

Parametri

Parametro	Descrizione
SourceConnection	Valore stringa che specifica una connessione al database di origine di cui eseguire l'aggiornamento. Se il database indicato da SourceConnection è già aperto, si verifica un errore.
DestConnection (facoltativo)	Valore stringa che specifica una connessione al database di destinazione se esiste un altro file che utilizza lo stesso nome. Se DestConnection viene passato come null, le proprietà richieste come LCID e Password sono derivate dal file di origine.

Valore restituito

Il tipo restituito è HRESULT e S_OK viene restituito al completamento.

Prototipo

HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);

Per aggiornare il file di database dalla versione 3.1 alla versione 3.5 di SQL Server Compact 3.5 senza creare un nuovo file, passare la stessa proprietà dell'origine dati nelle stringhe di connessione di origine e destinazione.

Osservazioni

I parametri SourceConnection e DestConnection specificano le proprietà dei database di origine e di destinazione. Nella tabella seguente vengono elencate le proprietà di connessione che è possibile impostare per ogni parametro. Tutte le altre proprietà di connessione vengono ignorate.

Proprietà	Descrizione
Data Source	Indica il nome del database. Questa proprietà è obbligatoria per le informazioni di connessione sia di origine che di destinazione.
Locale Identifier	Indica l'identificatore delle impostazioni locali (LCID) per il nuovo database. Se viene omesso, il database di destinazione avrà lo stesso LCID delle impostazioni locali del sistema. L'identificatore LCID specifica i criteri per il confronto delle stringhe all'interno del database.
SSCE:Database Password	Indica la password, se il database è protetto tramite password. Se il database di origine contiene una password, questa deve essere specificata. Se questo parametro viene omesso dalla stringa DestConnection, il nuovo database avrà la stessa password del database di origine. Se si desidera rimuovere la password dal database di destinazione, è necessario impostare la password del database come stringa vuota. La password del database può essere costituita da un massimo di 40 caratteri.
SSCE:Temp File Directory	Specifica il percorso del database temporaneo. Se questo parametro viene omesso dalla stringa DestConnection, come percorso del database temporaneo verrà utilizzato il percorso del database corrente.
SSCE:Encryption Mode	Specifica la modalità di crittografia della destinazione. Se questo valore non viene specificato, viene utilizzato Platform Default.
SSCE:Case Sensitive	Specifica se al database viene applicata o meno 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.

Per un elenco di valori LCID univoci, vedere Regole di confronto supportate (SQL Server Compact). Verificare che il dispositivo in cui si desidera creare il database supporti le impostazioni locali.

Per un elenco delle diverse modalità di crittografia, vedere Aggiornamento dalle versioni precedenti (SQL Server Compact).