Gets and sets the current FTP directory format type.

Syntax

object.DirectoryFormat [= format]

The object is an expression that evaluates to a FileTransfer object. The property returns a long integer value.

Remarks

Value	Constant	Description
0	fileDirectoryAutoDetect	This value specifies that the library should automatically determine the format of the file lists returned by the server. It is recommended that most applications use this value and allow the control to automatically determine the appropriate file listing format used by the server. This is the default value of the property.
1	fileDirectoryUnix	This value specifies that the server returns file lists in the format commonly used by UNIX servers. Note that many servers can be configured to return file listings in this format, even if they are not actually a UNIX based platform. Consult the technical reference documentation for your server for more information.
2	fileDirectoryMsdos	This value specifies that the server returns file lists in the format commonly used by MS-DOS based systems. This includes Windows IIS servers. Long file names will be returned if supported by the underlying filesystem, such as NTFS or FAT32.
3	fileDirectoryVms	This value specifies that the server returns file lists in the format commonly used by VMS servers. Note that VMS servers can be configured to return a standard UNIX style listing in additional to the default VMS format.
4	fileDirectorySterling1	This value specifies that the server returns file listings in a proprietary format used by the Sterling server, which is used for EDI (Electronic Data Interchange) applications. This format uses a 13 byte status code.
5	fileDirectorySterling2	This value specifies that the server returns file listings in a proprietary format used by the Sterling server, which is used for EDI (Electronic Data Interchange) applications. This format uses a 10 byte status code.
6	fileDirectoryNetWare	This value specifies that the server returns file listings in a proprietary format used by NetWare servers. The format is similar to UNIX style listings except that file access and permissions are indicated by letter codes enclosed in brackets. This is the default format selected if the server identifies itself as a NetWare system.

If this property has the default value fileDirectoryAutoDetect initially, and the control can determine from the format of the first file in the listing that one of the other supported types is used, then the property will change value upon the first call to the ReadDirectory method. If the control cannot determine the format of the directory listing, then the directory listing will be empty. In this case, you can retrieve a directory listing by setting the optional ParseList parameter of the OpenDirectory method to False. Each line of the directory listing provided by the server will be returned in FileName parameter of the ReadDirectory function. It will then be the responsibility of the application to extract desired information from this string.

Data Type

Integer

See Also

OpenDirectory Method, ReadDirectory Method

Copyright © 2008 Catalyst Development Corporation. All rights reserved.