TextWrite

obj -> TextWrite(alpha1, int2) : int

Text/Prozedur schreiben

Details

• obj: Textpuffer-Deskriptor
• alpha1: Textname
• int2: Optionen (siehe Text)
• Resultat: int Schreibresultat _rOk Schreiben erfolgreich _rLocked Text (alpha2) gesperrt _rNoRights Benutzerberechtigung nicht ausreichend _rDeadlock Verklemmung aufgetreten
• Siehe: Verwandte Befehle , TextOpen () , TextRead ()

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.

info

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:

• _TextLock Der geschriebene Text wird gesperrt.
• _TextSingleLock Der geschriebene Text wird einfach gesperrt.
• _TextSharedLock Der geschriebene Text wird mehrfach gesperrt.
• _TextUnlock Der geschriebene Text wird entsperrt.
• _TextExtern Der Text wird extern mit dem Namen (alpha1) gesichert.
• _TextOEM Die Option wird nur beim Zugriff auf eine externe Datei ausgewertet. Die Datei wird mit dem OEM-Zeichensatz geschrieben.
• _TextANSI Die Option wird nur beim Zugriff auf eine externe Datei ausgewertet. Die Datei wird mit dem ANSI-Zeichensatz geschrieben.
• _TextDba? 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 _TextDba2 bis _TextDba8 angegeben.
• _TextProc Die Prozedur (alpha1) wird geschrieben. Die gespeicherten Lesezeichen aus der Prozedur bleiben erhalten.
• _TextNoContents Der Textinhalt wird nicht gesichert.
• _TextClipBoard 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.