Navigation:  Klassen > bArrayServer >

bArrayServer:CopyToFile()

 Diese Seite drucken    Vorherige SeiteZurück zum Anfang des KapitelsNächste Seite

Zweck

Kopiert Datensätze in eine Datei.

Klasse

bArrayServer

Typ

Methode

Syntax

<oArrayServer>:CopyToFile(

<oDBFTarget> | <oFSTarget> | <cTarget>,

[<aiField> | <acField> | <asymField> | <aoDFField>],

[<uForCondition>],

[<uWhileCondition>],

[<uScope>]

[<symFormat>],

[<cDelimiter>],

[<symTextFormat>],

[<cDriver>],

[<acRDD>]

) Æ lSuccess

Argumente

<oDBFTarget>Ein Objekt der Klasse DBServer. In den DBServer werden die Datensätze kopiert. Der DBServer muss geöffnet sein. Das Argument wird nur unterstützt, wenn im Argument <symFormat> der Wert #DBF übergeben wird.
Datentyp:DBServer

 

<oFSTarget>Ein Dateipfad als FileSpec. Zu diesem Dateipfad wird die Zieldatei erzeugt. Eine vorhandene Datei wird überschrieben.
Datentyp:FileSpec

 

<cTarget>Ein Dateipfad als String. Zu diesem Dateipfad wird die Zieldatei erzeugt. Eine vorhandene Datei wird überschrieben.
Datentyp:String

 

<aiField>Ein Array mit Feldpositionen. Die Werte dieser Felder werden in die Zieldatei 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 Zieldatei 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 Zieldatei 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 Zieldatei 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 Zieldatei 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

 

<symFormat>Definiert das Format der Zieldatei. Es werden die folgenden Werte unterstützt:

 

Wert

Beschreibung

#DBF

DBase Datenbank

Mit Hilfe der Argumente <cDriver> und <acRDD> kann das Format der Datenbank definiert werden.

#SDF

Textdatei

Die einzelnen Datensätze in der Textdatei werden mit CRLF voneinander getrennt. Die Feldwerte innerhalb der Datensätze haben immer die gleiche Länge.

#Delimited

Textdatei

Die einzelnen Datensätze in der Textdatei werden mit CRLF voneinander getrennt. Die einzelnen Feldwerte innerhalb eines Datensatzes werden mit dem Zeichen voneinander getrennt, welches in dem Argument <cDelimiter> definiert wurde.

 

Datentyp:Symbol

 

<cDelimiter>Ein einzelnes Zeichen, welches als Trennzeichen zwischen den einzelnen Feldern eines Datensatzes in die Zieldatei geschrieben wird. Das Argument wird nur unterstützt, wenn im Argument <symFormat> der Wert #Delimited übergeben wird. Als Vorgabe wird das Zeichen "," verwendet.
Datentyp:String

 

<symTextFormat>Definiert das Format, in dem Feldwerte vom Datentyp STRING in die Zieldatei kopiert werden. Es werden die folgenden Werte unterstützt:

 

Wert

Beschreibung

#None

Texte werden ohne Anführungszeichen in die Zieldatei kopiert.

#Double

Texte werden mit doppelten Anführungszeichen " in die Zieldatei kopiert.

#Simple

Texte werden mit einfachen Anführungszeichen ' in die Zieldatei kopiert.

 

Das Argument wird nur unterstützt, wenn im Argument <symFormat> der Wert #Delimited übergeben wird. Als Vorgabe wird der Wert #None verwendet.

Datentyp:Symbol

 

<cDriver>Der Name des RDD für die Ziel-Datenbank. Das Argument wird nur unterstützt, wenn im Argument <symFormat> der Wert #DBF übergeben wird. 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 Ziel-Datenbank verwendet werden. Das Argument wird nur unterstützt, wenn im Argument <symFormat> der Wert #DBF übergeben wird. Als Vorgabe werden keine zusätzlichen RDD's verwendet.
Datentyp:Array

Rückgabewert

lSuccessEin Logischer Wert der definiert, ob die Datensätze in die Zieldatei kopiert werden konnten.
TRUEDie Datensätze wurden kopiert.
FALSEDie Datensätze konnten nicht kopiert werden.
Datentyp:Logic

Beschreibung

bArrayServer:CopyToFile() kopiert alle oder einzelne Datensätze aus dem ArrayServer in eine Zieldatei. Wenn die Zieldatei 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 Zieldatei kopiert.

 

Beim Erzeugen der Zieldatei werden nur Felder berücksichtigt, die vom Datentyp "C", "D", "L", oder "N" sind. Bei einer DBF-Zieldatei wird zusätzlich noch der Datentyp "M" berücksichtigt. Felder mit anderen Datentypen werden ignoriert.

 

Hinweis!

Nach dem Kopieren ist der Datensatzzeiger unverändert.

Siehe auch

bArrayServer:CopyDB()

bArrayServer:CopyDelimited()

bArrayServer:CopySDF()

bArrayServer:CopyStructure()

 

Page url: http://www.YOURSERVER.com/index.html?barrayserver_copytofile.htm