Pulsanti di comando di Address Book

  • Articolo

L'applicazione Rubrica include i seguenti pulsanti di comando:

  • Pulsante Trova per inviare una query al database.

  • Pulsante Cancella per cancellare le caselle di testo prima di avviare una nuova ricerca.

  • Pulsante Aggiorna profilo per salvare le modifiche a un record di un dipendente.

  • Pulsante Annulla modifiche per rimuovere le modifiche.

Importante

A partire da Windows 8 e Windows Server 2012, i componenti del server di RDS non sono più inclusi nel sistema operativo Windows. Per altri dettagli, vedere la Guida di riferimento per la compatibilità di Windows 8 e Windows Server 2012. I componenti del client di RDS verranno rimossi in una versione futura di Windows. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Le applicazioni che usano RDS devono eseguire la migrazione a WCF Data Service.

Pulsante Trova

Facendo clic sul pulsante Trova viene attivata la routine VBScript Find_OnClick Sub, che compila e invia la query SQL. Facendo clic su questo pulsante viene popolata la griglia di dati.

Compilazione della query SQL

La prima parte della routine Sub Find_OnClick compila la query SQL, una frase alla volta, aggiungendo stringhe di testo a un'istruzione SQL SELECT globale. Inizia impostando la variabile myQuery su un'istruzione SQL SELECT che richiede tutte le righe di dati dalla tabella dell'origine dati. Successivamente, la routine Sub analizza ognuna delle quattro caselle di input nella pagina.

Poiché il programma usa la parola like nella compilazione delle istruzioni SQL, le query sono ricerche di substring anziché corrispondenze esatte.

Ad esempio, se la casella Cognome contiene la voce "Berge" e la casella Titolo contiene la voce "Program Manager", l'istruzione SQL (valore di myQuery) legge:

Select FirstName, LastName, Title, Email, Building, Room, Phone from Employee where lastname like 'Berge%' and title like 'Program Manager%'

Se la query ha esito positivo, tutte le persone con un cognome contenente il testo "Berge" (ad esempio Berge e Berger) e con un titolo contenente le parole "Program Manager" (ad esempio Program Manager, Advanced Technologies) vengono visualizzate nella griglia di dati HTML.

Preparazione e invio della query

L'ultima parte della routine Sub Find_OnClick è costituita da due istruzioni. La prima istruzione assegna la proprietà SQL dell’oggetto RdS.DataControl uguale alla query SQL compilata dinamicamente. La seconda istruzione fa in modo che l’oggetto RDS.DataControl (DC1) esegua una query sul database e quindi visualizzi i nuovi risultati della query nella griglia.

Sub Find_OnClick  
   '...  
   DC1.SQL = myQuery  
   DC1.Refresh  
End Sub

Pulsante Aggiorna profilo

Facendo clic sul pulsante Aggiorna profilo viene attivata la routine Sub VBScript Update_OnClick, che esegue i metodi SubmitChanges e Refresh dell’oggetto RDS.DataControl (DC1).

Sub Update_OnClick  
   DC1.SubmitChanges  
   DC1.Refresh  
End Sub

Quando DC1.SubmitChanges viene eseguito, Servizio dati remoti crea un pacchetto di tutte le informazioni sull'aggiornamento e lo invia al server tramite HTTP. L'aggiornamento è di tipo “tutto o niente”: se una parte dell'aggiornamento ha esito negativo, nessuna delle modifiche viene apportata e viene restituito un messaggio di stato. DC1.Refresh non è necessario dopo SubmitChanges con Servizio dati remoti, ma garantisce dati aggiornati.

Pulsante Annulla modifiche

Facendo clic su Annulla modifiche viene attivata la routine Sub VBScript Cancel_OnClick, che esegue il metodo CancelUpdate dell’oggetto RDS.DataControl (DC1).

Sub Cancel_OnClick  
   DC1.CancelUpdate  
End Sub

Quando DC1.CancelUpdate viene eseguito, rimuove eventuali modifiche apportate da un utente a un record di un dipendente nella griglia di dati dall'ultima query o aggiornamento. Ripristina i valori originali.

Vedi anche

Pulsanti di spostamento di Address Book
Oggetto DataControl (Servizi Desktop remoto)