Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Aggiornamento: novembre 2007
Quando la proprietà CustomTool in un file di schema XSD è impostata su MSResultSetGenerator, vengono generati oggetti datasource di ResultSet tipizzati invece degli oggetti datasource di DataSet tipizzati solitamente generati. Gli oggetti ResultSet sono cursori di database veloci che supportano l'associazione dati dell'interfaccia utente, lo scorrimento in avanti e indietro dei dati e l'aggiornamento dei dati nel database. Poiché costituiscono un modello a connessione continua, i ResultSet mantengono una connessione sempre attiva con il database.
Funzionalità dei ResultSet tipizzati
Gli oggetti ResultSet tipizzati generati forniscono un accesso indipendente dai tipi alla tabella di database, analogamente agli oggetti DataSets tipizzati. Di conseguenza, il codice generato garantisce che i dati passati tra applicazione e database corrispondano correttamente allo schema di database in fase di compilazione. Il codice generato da oggetti ResultSet tipizzati estende la classe di base ResultSet di SQL Server Compact 3.5 in modo che fornisca proprietà e metodi specifici della tabella di database di destinazione.
Nei paragrafi seguenti vengono riepilogate le funzionalità del codice generato per un oggetto ResultSet tipizzato.
Costruttori L'oggetto ResultSet tipizzato generato contiene due costruttori. Il costruttore predefinito viene utilizzato sia per scenari in fase di progettazione che per scenari di base in fase di esecuzione. Per la fase di progettazione di Visual Studio è necessaria la connessione del costruttore predefinito al database nel computer di sviluppo locale. Pertanto, il codice generato contiene una stringa di connessione al file di database SQL Server Compact 3.5 locale. Per la fase di esecuzione, il costruttore predefinito passa al file di database SQL Server Compact 3.5 locale dalla stessa directory dell'applicazione in esecuzione. Questo è uno scenario di base in fase di esecuzione.
Stringhe di connessione Quando lo scenario relativo alla fase di esecuzione è complesso, ad esempio quando il file di database SQL Server Compact 3.5 non°si trova nella directory di esecuzione o la stringa di connessione viene modificata in altro modo, ad esempio con una password, è possibile utilizzare il costruttore di overload. Nel costruttore di overload vengono utilizzati due argomenti: una stringa di connessione personalizzata e un flag ResultSetOptions.
Proprietà di connessione La proprietà di connessione è l'oggetto SqlCeConnection attivo utilizzato dall'oggetto ResultSet tipizzato per accedere ai dati del database. La proprietà di connessione è pubblica e consente l'accesso per la gestione dello stato della connessione per il ResultSet tipizzato. Ad esempio, potrebbe essere necessario chiudere la connessione per alcune transazioni.
Accesso indipendente dai tipi a colonne di tabelle Il codice generato crea una funzione di accesso a ciascuna colonna della tabella dei dati. Il tipo di proprietà è determinato eseguendo il mapping del tipo di database sottostante a un tipo .NET Framework. Il tipo nvarchar è ad esempio mappato a una stringa .NET Framework. Poiché la proprietà generata supporta entrambe le funzioni di accesso Get e Set, è possibile effettuare il pull e il push dei dati tramite stringhe .NET Framework anziché tramite il tipo nvarchar del database sottostante. Ogni colonna dispone inoltre di un metodo IsxxxDBNull e SetxxxDBNull, dove xxx rappresenta il nome della colonna, per consentire di ottenere DBNull dal database e di impostare DBNull nel database.
Metodo AddxxxRecord (dove xxx rappresenta il nome della tabella) Questo metodo consente l'aggiunta di nuove righe nella tabella di database. Il metodo AddxxxRecord dispone di un parametro per ogni colonna della tabella di dati, fatta eccezione per le colonne con incremento automatico, i cui valori vengono assegnati dal modulo di gestione di database. Ogni parametro viene nuovamente dichiarato come tipo .NET Framework e questo consente un semplice utilizzo con l'applicazione e l'estrazione del tipo di database sottostante. Non è necessario chiamare l'aggiornamento dopo la chiamata del metodo. Dopo la chiamata, viene eseguito il commit della nuova riga nel database.
Metodo DeletexxxRecord (dove xxx rappresenta il nome della tabella) Questo metodo elimina le righe correnti dal database. A differenza del caso dei DataSet, questa transizione non viene memorizzata nella cache e, dopo essere stata chiamata, la riga viene eliminata dal database. Non è necessario chiamare il metodo Update dopo avere chiamato questo metodo.
Metodo Bind Il metodo Bind accetta un parametro, BindingSource, con associazione dati a uno o più controlli dell'interfaccia utente nel form. Questo metodo esegue quindi l'associazione di BindingSource all'istanza dell'oggetto ResultSet tipizzato, completando la catena di associazione dati e consentendo ai controlli di visualizzare i dati direttamente nel database.
.gif "Nota")
Nota:Lo scenario relativo alla fase di progettazione richiede una stringa di connessione specificata a livello di codice (hard-coded) per il database SQL Server Compact 3.5. Questa stringa di connessione può diventare obsoleta se, ad esempio, un progetto viene condiviso tra uno sviluppatore e l'altro. Di conseguenza, il progetto non può essere aperto dalla finestra DataSource o da Progettazione Windows Form oppure da entrambi. È possibile rigenerare il codice ResultSet tipizzato per risolvere questa situazione. In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di schema XSD e scegliere Esegui strumento personalizzato.
Vedere anche
Concetti
Confronto tra gruppi di risultati e dataset (dispositivi)