PUTFILE( )-Funktion

Ruft das Dialogfeld Speichern unter auf und gibt den angegebenen Dateinamen zurück.

PUTFILE([cCustomText] [, cFileName] [, cFileExtensions])

Rückgabewerte

Zeichen

Parameter

• cCustomText
  Gibt den Text an, der in dem Dialogfeld Speichern unter angezeigt werden soll.

• cFileName
  Gibt den Dateinamen an, der standardmäßig in dem Textfeld angezeigt wird.

• cFileExtensions
  Gibt die Dateinamenerweiterungen an. Wenn das Kontrollkästchen Alle Dateien deaktiviert ist, werden im entsprechenden Listenfeld des Dialogfeldes Speichern unter nur die Namen der Dateien angezeigt, die eine der angegebenen Erweiterungen haben. Die erste der in cFileExtensions angegebenen Erweiterungen wird an den jeweils eingegebenen Dateinamen angehängt, wenn dieser keine Erweiterung umfasst. Eine Liste mit den Visual FoxPro-Dateierweiterungen und den entsprechenden Creator Types finden Sie in der Hilfe unter Dateierweiterungen und Dateitypen.

  Der Zeichenausdruck cFileExtensions kann eines der folgenden Formate besitzen:

  • cFileExtensions kann eine Erweiterung enthalten (z. B. PRG), so dass nur die Dateinamen mit dieser Erweiterung angezeigt werden.
  • cFileExtensions kann eine Liste mit Dateinamenerweiterungen enthalten, die durch Semikolons voneinander getrennt sind. Wenn Sie beispielsweise PRG;FXP aufnehmen, zeigt Visual FoxPro alle Dateinamen mit den Erweiterungen PRG und FXP an.
  • Wenn Dateinamen denselben Stammnamen mit unterschiedlichen Erweiterungen besitzen (z. B. Customer.prg und Customer.fxp), zeigt Visual FoxPro nur den Dateinamen mit der Erweiterung an, die in cFileExtensions als erste angezeigt wird.
  • cFileExtensions kann eine Liste mit Dateinamenerweiterungen enthalten, die durch vertikale Trennstriche voneinander getrennt sind (PRG|FXP). In diesem Fall zeigt Visual FoxPro selbst dann alle Dateinamen mit den aufgelisteten Erweiterungen an, wenn diese identische Stammnamen besitzen.
  • Wenn cFileExtensions nur ein Semikolon (;) enthält, zeigt Visual FoxPro alle Dateinamen an, die keine Erweiterung haben.
  • Wenn es sich bei cFileExtensions um eine leere Zeichenfolge handelt, zeigt Visual FoxPro die Namen aller Dateien an, die sich im aktuellen Verzeichnis oder Ordner befinden.
  • Wenn cFileExtensions MS-DOS-Platzhalter enthält, wie z. B. Fragezeichen (?) und Sternchen (*), zeigt Visual FoxPro alle Dateien mit den Erweiterungen an, die die Platzhalterkriterien erfüllen. Wenn beispielsweise cFileExtensions gleich ?X? ist, werden alle Dateinamen mit den Erweiterungen FXP, EXE, TXT usw. angezeigt.

Hinweise

Mit PUTFILE( ) können Sie einen vorhandenen Dateinamen auswählen oder einen neuen Dateinamen angeben. PUTFILE( ) gibt den Dateinamen zusammen mit dem Pfad zurück. Wenn Sie keinen Dateinamen eingeben, gibt PUTFILE( ) den voreingestellten Dateinamen (in cFileName angegeben) und die voreingestellte Erweiterung (in cFileExtensions angegeben) zurück. Wenn Sie Abbrechen wählen oder die ESC-Taste drücken, gibt PUTFILE( ) eine leere Zeichenfolge zurück. Sie können mit dem von PUTFILE( ) zurückgegebenen Dateinamen eine Datei benennen und diese auf der Festplatte speichern.

Beispiel

Das folgende Beispiel erstellt eine Datendatei mit Trennzeichen aus einer beliebigen vom Benutzer ausgewählten Tabelle. GETFILE( ) wird verwendet, um die Tabelle zu finden und zu öffnen, und PUTFILE( ) wird verwendet, um den Namen der Zieldatei zurückzugeben.

gcTableName = GETFILE('DBF', 'Open Table:')
USE (gcTableName)
gcDelimName = ALIAS( ) + '.DLM'
gcDelimFile = PUTFILE('Delimited file:', gcDelimName, 'DLM')
IF EMPTY(gcDelimFile)  && Esc pressed
   CANCEL
ENDIF
COPY TO (gcDelimFile) DELIMITED   && Create delimited file
MODIFY FILE (gcDelimFile) NOEDIT

Siehe auch

FILE( ) | GETEXPR | GETFILE( ) | GETPICT( ) | LOCFILE( )