Inhaltsverzeichnis

24.6.4 Klasse Request

Die Klasse Request (gb.web) können Sie verwenden, um HTTP-Anfragen (HTTP-Requests) an einen HTTP-Server zu schreiben. Beispiele für die praktische Realisierung finden Sie im Kapitel 24.6.8 Projekte.

24.6.4.1 Eigenschaften

Die Klasse Request verfügt über diese Eigenschaften:

EigenschaftDatentypBeschreibung
CookiesCollectionErmittelt eine Übersicht aller Cookies, die in einer HTTP-Anfrage (Request) enthalten sind.
DebugBooleanGibt True zurück, wenn der Debug-Modus eingeschaltet ist oder setzt den Debug-Modus. Wenn der Debug-Modus eingeschaltet ist, so wird der Inhalt des Post-Request gespeichert und kann über die Eigenschaft Request.Post.Contents ausgelesen werden.
DelimiterStringSetzt das Zeichen, das die Felder in einer GET- oder application/x-www-form-urlencoded-POST-Anfrage begrenzt oder gibt das Trenn-Zeichen zurück. Das Zeichen '&' ist das Standard-Trennzeichen.
FieldsString[ ]Speichert eine Liste der Namen aller Feld-Variablen, die im Request enthalten sind, in einem String-Array.
FilesCollectionErmittelt eine Auflistung aller Dateien, die dem Request beigefügt sind. Die Schlüssel dieser Collection sind die Datei-Namen, die im Request angegeben sind. Die Werte der Collection ist der Pfad der auf dem Server gespeicherten Dateien. Alle Dateien werden in das temporäre Verzeichnis der Anwendung hochgeladen. Sie werden zerstört, sobald die Anwendung beendet wird.
InternetExplorerIntegerGibt die Version des Internet-Explorers als HTTP-Client zurück oder NULL, wenn der Internet-Explorer nicht der HTTP-Client ist.
PathStringGibt den Request-Pfad der CGI-Applikation zurück. Ist das Äquivalent zu CGI[„PATH_INFO“].
QueryStringGibt den Abfrage-Teil der Anfrage zurück. Ist das Äquivalent zu CGI[„QUERY_STRING“].
MethodStringGibt die Methode „POST“ oder „GET“ der CGI-Applikation zurück, mit der Anfragen verschickt werden (Äquivalent zu CGI[„REQUEST_METHOD“]).
LanguageStringDer Browser teilt dem Server bei einem Request mit, auf welche Sprache er eingestellt ist. Verwenden Sie System.Language = Request.Language, um die Webseite zu internationalisieren.

Tabelle 24.6.4.1.1 : Eigenschaften der Klasse Request

Die Eigenschaft Request.Get liefert ein virtuelles Objekt '_Request_Get' zurück, um die in der GET-Anfrage gespeicherten Daten abrufen zu können, während die Eigenschaft Request.Post ein virtuelles Objekt '_Request_Post' zurück gibt, um die in der POST-Anfrage gespeicherten Daten abzurufen.

EigenschaftDatentypBeschreibung
_Get.FieldsString[ ]Gibt ein Daten-Array zurück, das alle im GET-Request-URL enthaltenen Felder enthält.
_Post.ContentsStringGibt den Request-Inhalt zurück, sofern die Eigenschaft 'Request.Debug' auf den Wert True gesetzt ist.
_Post.FieldsString[ ]Liefert ein Daten-Array mit allen Feldern im POST-Request-Inhalt zurück.
_Post.FilesCollectionGibt eine Sammlung (Collection) der Dateien zurück, die mit dem POST-Request geschickt wurden. Der Schlüssel enthält den Dateinamen und der Dateipfad ist als korrespondierender Wert in dieser Sammlung gespeichert.

Tabelle 24.6.4.1.2 : Eigenschaften der virtuellen Klassen _Request_Get und _Request_Post

Hinweise:

24.6.4.2 Methoden

Die Klasse Request (gb.web) besitzt nur eine Methode:

Static Function Exist ( Field As String ) As Boolean 

Die Funktion gibt True zurück, wenn das angegebene Feld in der HTTP-Anfrage existiert – unabhängig von der verwendeten Methode GET oder POST.

Auch die beiden virtuellen Klassen _Request_Get und _Request_Post besitzen jeweils eine Methode:

Function _Request_Get.Exist ( Field As String ) As Boolean
Function _Request_Post.Exist ( Field As String ) As Boolean

Beide Funktionen geben jeweils als Funktionswert True zurück, wenn das angegebene Feld in der GET- oder POST-Anfrage existiert.

Download