Adress Book-Befehlsschaltflächen

Artikel
05/30/2023

Die Adressbuchanwendung umfasst die folgenden Befehlsschaltflächen:

Eine Schaltfläche Suchen, um eine Abfrage an die Datenbank senden.
Eine Schaltfläche Löschen, um den Inhalt der Textfelder zu entfernen, bevor Sie eine neue Suche starten.
Eine Schaltfläche Profil aktualisieren, um Änderungen an einem Mitarbeiterdatensatz zu speichern.
Eine Schaltfläche Änderungen verwerfen, um Änderungen zu verwerfen.

Wichtig

Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.

Schaltfläche „Suchen“

Wenn Sie auf die Schaltfläche Suchen klicken, wird die Sub-Prozedur „VBScript Find_OnClick“ aktiviert, die die SQL-Abfrage erstellt und sendet. Durch Klicken auf diese Schaltfläche wird das Datenraster aufgefüllt.

Erstellen der SQL-Abfrage

Im ersten Teil der Sub-Prozedur „Find_OnClick“ wird die SQL-Abfrage erstellt (jeweils ein Ausdruck), indem Textzeichenfolgen an eine globale SQL SELECT-Anweisung angefügt werden. Dabei wird zunächst die Variable myQuery auf eine SQL SELECT-Anweisung festgelegt, die alle Datenzeilen aus der Datenquellentabelle anfordert. Als Nächstes überprüft die Sub-Prozedur jedes der vier Eingabefelder auf der Seite.

Da das Programm das Wort like beim Erstellen der SQL-Anweisungen verwendet, sind die Abfragen keine exakten Übereinstimmungen, sondern substring-Suchvorgänge.

Wenn das Feld Nachname z. B. den Eintrag „Berge“ und das Feld Position den Eintrag „Program Manager“ enthält, lautet die SQL-Anweisung (Wert myQuery) wie folgt:

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

Bei einer erfolgreichen Abfrage werden im HTML-Datenraster alle Personen angezeigt, deren Nachname den Text „Berge“ (z. B. „Berge“ und „Berger“) und deren Position die Wörter „Program Manager“ (z. B. „Program Manager, Advanced Technologies“) enthält.

Vorbereiten und Senden der Abfrage

Der letzte Teil der Sub-Prozedur „Find_OnClick“ besteht aus zwei Anweisungen. Mit der ersten Anweisung wird die SQL-Eigenschaft des RDS.DataControl-Objekts zugewiesen (wie bei der dynamisch erstellten SQL-Abfrage). Durch die zweite Anweisung fragt das RDS.DataControl-Objekt (DC1) die Datenbank ab. Die neuen Ergebnisse der Abfrage werden anschließend im Raster angezeigt.

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

Schaltfläche „Profil aktualisieren“

Wenn Sie auf die Schaltfläche Profil aktualisieren klicken, wird die Sub-Prozedur „VBScript Update_OnClick“ aktiviert, die die SubmitChanges- und Refresh-Methode des RDS.DataControl-Objekts (DC1) ausführt.

Sub Update_OnClick  
   DC1.SubmitChanges  
   DC1.Refresh  
End Sub

Bei der Ausführung von DC1.SubmitChanges erstellt der Remotedatendienst ein Paket mit allen Updateinformationen und sendet das Paket über HTTP an den Server. Beim Update müssen alle Änderungen erfolgreich sein. Kann ein Teil des Updates nicht ausgeführt werden, werden keine der Änderungen vorgenommen, und es wird eine Statusmeldung zurückgegeben. DC1.Refresh ist nach SubmitChanges mit dem Remotedatendienst nicht erforderlich, stellt jedoch die Aktualität der Daten sicher.

Schaltfläche „Änderungen verwerfen“

Wenn Sie auf Änderungen verwerfen klicken, wird die Sub-Prozedur „VBScript Cancel_OnClick“ aktiviert, die die CancelUpdate-Methode des RDS.DataControl-Objekts (DC1)) ausführt.

Sub Cancel_OnClick  
   DC1.CancelUpdate  
End Sub

Bei der Ausführung von DC1.CancelUpdate werden alle Änderungen verworfen, die von Benutzer*innen seit der letzten Abfrage oder seit dem letzten Update an einem Mitarbeiterdatensatz im Datenraster vorgenommen wurden. Stattdessen werden die ursprünglichen Werte wiederhergestellt.

Weitere Informationen

Adress Book-Navigationsschaltflächen
DataControl-Objekt (RDS)

Teilen über