Zum Hauptinhalt springen

SelRead

obj -> SelRead(int1, int2[, alpha3]) : int​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von Clients mit Programmierschnittstelle Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service

Selektion lesen

Details

  • obj: Selektionspuffer-Deskriptor
  • int1: Dateinummer
  • int2: Optionen (siehe Text)
  • alpha3: Selektionsname (optional)
  • Resultat: int Leseresultat _rOk Lesen erfolgreich _rLocked Selektion (alpha3) gesperrt _rNoKey Selektion (alpha3) nicht vorhanden, nächste Selektion gelesen _rNoRec Keine weitere Selektion vorhanden _rLastRec Selektion (alpha3) nicht vorhanden, letzte Selektion gelesen Anweisung setzt den globalen Fehlerwert
  • Siehe: Verwandte Befehle , SelOpen () , DbSelection , Beispiel

Mit dieser Funktion wird die Selektion (alpha3) aus der Datei (int1) in den Puffer (obj) geladen. Der Puffer muss zuvor mit dem Befehl SelOpen () eingerichtet werden. Sofern die angegebene Selektion nicht vorhanden ist, wird die Selektion mit dem nächstgrößeren Namen geladen und _rNoKey zurückgeliefert. Bei Verwendung von _SelFirst, _SelLast, _SelNext und _SelPrev kann auf den Selektionsnamen verzichtet werden.

In (int2) können folgende Optionen angegeben werden:

  • _SelFirst Die erste Selektion der Datei wird geladen.
  • _SelLast Die letzte Selektion der Datei wird geladen.
  • _SelPrev Die Selektion mit dem nächstkleineren Namen wird geladen. Sofern keine weitere Selektion in der Datei vorhanden ist, wird als Resultat _rNoRec zurückgeliefert.
  • _SelNext Die Selektion mit dem nächstgrößeren Namen wird geladen. Sofern keine weitere Selektion in der Datei vorhanden ist, wird als Resultat _rNoRec zurückgeliefert.
  • _SelLock Die gelesene Selektion wird gesperrt. Dies ist nur dann der Fall, wenn _rOk zurückgeliefert wird (Selektion vorhanden). Ist die Selektion durch einen anderen Benutzer gesperrt, so ist das Resultat _rLocked.
  • _SelSharedLock Die gelesene Selektion wird gesperrt. Andere Benutzer können noch lesend auf die Selektion zugreifen. Mit dieser Sperr-Option kann die Selektion nur gelesen, nicht aber geändert werden. Soll die Selektion verändert werden, muss sie mit der Option _SelLock gesperrt werden.
  • _SelUnlock Die gelesene Selektion wird entsperrt.
  • _SelKeyMode Alternativer Verarbeitungsmodus
  • _SelKeyUpdate Schlüsselwerte in Selektion aktualisieren

Die Angabe von _SelLock ist notwendig, wenn mit den Ergebnismengen der Selektion gearbeitet werden soll (siehe SelClear (), SelRecInsert (), SelRecDelete (), RecRead () und RecLink ()).

Die gelesene Selektionsmenge kann in einem RecList -Objekt angezeigt werden, in dem der von SelOpen () zurückgegebene Deskriptor in die Eigenschaft DbSelection eingetragen wird.

info

Eine Selektion sollte immer dann verwendet werden, wenn ein deutlich kleinerer Teil der Datensätze das Selektionskriterium erfüllt. Als Alternative können auch Filter oder Verknüpfungen zum Einschränken der Anzahl der Datensätze verwendet werden.

Beispiel

tHdlSel # SelOpen();
tErg # tHdlSel->SelRead(tblCstCustomer, _SelLock, 'SEL_PLZ');
tErg # tHdlSel->SelRun();
...

Mögliche Laufzeitfehler: