Zweck
Kopiert Datensätze in eine DBF Datei.
Klasse
Typ
Methode
Syntax
<oArrayServer>:CopyDB(
<oDBFTarget> | <oFSTarget> | <cTarget>,
[<aiField> | <acField> | <asymField> | <aoDFField>],
[<uForCondition>],
[<uWhileCondition>],
[<uScope>],
[<cDriver>],
[<acRDD>]
) Æ lSuccess
Argumente
<oDBFTarget> | Ein Objekt der Klasse DBServer. In den DBServer werden die Datensätze kopiert. Der DBServer muss geöffnet sein. |
Datentyp: | DBServer |
<oFSTarget> | Ein Dateipfad als FileSpec. Zu diesem Dateipfad wird die DBF Datei erzeugt und im exklusiven Mode geöffnet. Eine vorhandene Datei wird überschrieben. |
Datentyp: | FileSpec |
<cTarget> | Ein Dateipfad als String. Zu diesem Dateipfad wird die DBF Datei erzeugt und im exklusiven Mode geöffnet. Eine vorhandene Datei wird überschrieben. |
Datentyp: | String |
<aiField> | Ein Array mit Feldpositionen. Die Werte dieser Felder werden in die DBF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet. |
Datentyp: | Array |
<acField> | Ein Array mit Feldnamen als String. Die Werte dieser Felder werden in die DBF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet. |
Datentyp: | Array |
<asymField> | Ein Array mit Feldnamen als Symbol. Die Werte dieser Felder werden in die DBF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet. |
Datentyp: | Array |
<aoDFField> | Ein Array mit Feldern als DataField. Die Werte dieser Felder werden in die DBF Datei kopiert. Als Vorgabe werden alle Felder des ArrayServer verwendet. |
Datentyp: | Array |
<uForCondition> | Eine Bedingung, die für jeden Datensatz innerhalb des Scopes ausgewertet wird. Es werden nur Datensätze in die DBF Datei kopiert, bei denen die Auswertung der Bedingung den Wert TRUE ergibt. |
Datentyp: | String | Codeblock | _Codeblock |
<uWhileCondition> | Eine Bedingung, die für jeden Datensatz innerhalb des Scopes ausgewertet wird. Sobald die Bedingung den Wert FALSE ergibt, werden keine weiteren Datensätze kopiert. |
Datentyp: | String | Codeblock | _Codeblock |
<uScope> | Definiert den Bereich der Datensätze, die beim Kopieren berücksichtigt werden sollen. Es werden die folgenden Werte unterstützt: |
Wert |
Beschreibung |
DBSCOPEALL |
Es werden alle Datensätze berücksichtigt. |
DBSCOPEREST |
Es werden alle Datensätze ab dem aktuellen Datensatz berücksichtigt. |
<iRecords> |
Anzahl der Datensätze, die ab dem aktuellen Datensatz berücksichtigt werden. |
Datentyp: | Logic | Int |
<cDriver> | Der Name des RDD für die DBF Datei. Als Vorgabe wird das Standard RDD (RDDSetDefault()) verwendet. |
Datentyp: | String |
<acRDD> | Ein Array mit den Namen von RDD's, die zusätzlich zu dem Haupt-RDD für die DBF Datei verwendet werden. Als Vorgabe werden keine zusätzlichen RDD's verwendet. |
Datentyp: | Array |
Rückgabewert
lSuccess | Ein Logischer Wert der definiert, ob die Datensätze in die DBF Datei kopiert werden konnten. |
TRUE | Die Datensätze wurden kopiert. |
FALSE | Die Datensätze konnten nicht kopiert werden. |
Datentyp: | Logic |
Beschreibung
bArrayServer:CopyDB() kopiert alle oder einzelne Datensätze aus dem ArrayServer in eine DBF Datei. Wenn die DBF Datei bereits existiert, dann wird diese überschrieben. Der Verzeichnispfad auf die Datei muss bereits existieren. Er wird nicht automatisch erzeugt.
Wenn im Argument 2 keine spezielle Feldliste übergeben wird, dann werden alle Felder des ArrayServer in die Textdatei kopiert.
Beim Erzeugen der DBF Datei werden nur Felder berücksichtigt, die vom Datentyp "C", "D", "L", "M" oder "N" sind. Felder mit anderen Datentypen werden ignoriert. Des Weiteren werden die Namen der Felder auf das Format von DBF-Feldnamen angepasst. Hierbei werden nicht alpha-numerische Zeichen im Feldnamen durch das Zeichen "_" ersetzt. Lange Feldnamen werden auf 10 Zeichen abgeschnitten. Entstehen hierdurch doppelte Feldnamen, dann wird der Feldname auf 7 Zeichen gekürzt und mit einer aufsteigenden laufenden Nummer versehen.
Anmerkungen
Nach dem Kopieren ist der Datensatzzeiger unverändert.
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?barrayserver_copydb.htm