TextWrite
Mit dieser Funktion wird der Inhalt des Textpuffers (obj) als Text (alpha1) gesichert, sofern der Benutzer ausreichende Berechtigung besitzt.
Wurde der Textpuffer mit 0 KB Größe angelegt (siehe TextOpen()) wird nur der Textkopf ohne den Textinhalt gesichert.
Wird der Text in der Datenbank gespeichert ist zu beachten, dass der Textname (alpha1) maximal 20 Zeichen lang sein darf. Zusätzlich ist die Größe von internen Texten und Prozeduren auf ca 119 MB (nach Anzahl Blöcken) beschränkt. Wird dieses Limit überschritten, wird der Laufzeitfehler _ErrLimitExceeded ausgelöst. Der bis zu diesem Limit geschriebene Textinhalt ist in diesem Fall weiterhin vorhanden.
Folgende Optionen (int2) sind zulässig:
-
Der geschriebene Text wird gesperrt.
-
Der geschriebene Text wird einfach gesperrt.
-
Der geschriebene Text wird mehrfach gesperrt.
-
Der geschriebene Text wird entsperrt.
-
Der Text wird extern mit dem Namen (alpha1) gesichert.
-
Die Option wird nur beim Zugriff auf eine externe Datei ausgewertet. Die Datei wird mit dem OEM-Zeichensatz geschrieben.
-
Die Option wird nur beim Zugriff auf eine externe Datei ausgewertet. Die Datei wird mit dem ANSI-Zeichensatz geschrieben.
-
Die Operation bezieht sich auf einen Text in einer anderen Datenbank. Die Datenbank wurde zuvor mit ``DbaConnect
()mit einem Nummernbereich verbunden. Der Nummernbereich wird in der Option mit_TextDba2bis_TextDba8angegeben. -
Die Prozedur (alpha1) wird geschrieben. Die gespeicherten Lesezeichen aus der Prozedur bleiben erhalten.
-
Der Textinhalt wird nicht gesichert.
-
Der Inhalt des Textpuffers wird in die Windows-Zwischenablage übertragen.
Mögliche Laufzeitfehler:
_ErrHdlInvalid: Textpuffer-Deskriptor (obj) ungültig_ErrStringOverflow: Textname (alpha1) zu lang_ErrLimitExceeded: Das Limit für interne Texte und Prozeduren (ca. 119 MB) ist überschritten.