Get a listing of a folder's contents via the ListingFolderItem event. The event is triggered once for each file, folder or link found in the folder being listed.
The sFolderMask parameter lets you specify a filtering mask using wildcards (such as "*.txt") in order to limit which items are listed. The same parameter also allows you to specify a path portion in order to list the contents of another folder. The path portion of the mask may be relative to the current folder, or absolute to the remote system. For example, if the FTP server's current working folder is "/cars", here's what various possibilities for the sFolderMask parameter will do:
"*" or "" will list all files in the /cars folder (the current working folder)
"*.txt" will list all items with the ".txt" extension in the /cars folder
"/pictures/*.gif"will list all items with the ".gif" extension in the /cars/pictures folder
"/pictures/*" will list all items in the /cars/pictures folder
This method can only be used when the CurrentState property's value is fcsConnected.
| Parameter | Description |
|---|---|
| sFolderMask | The mask or the path and mask for filtering listing. If this parameter is left empty, all items in the will be listed. |
The ListParsingFlags property determines if the XceedFtp control should parse the FTP server’s directory listing data or leave it up to your application to parse the data by handling the ParsingListLine event.
| Declaration | |
|---|---|
ListFolderContents( [in] BSTR sFolderMask ) | |
AccountName, ListParsingFlags, PassiveMode
ListingFolderItem, LoggingCommandLine, ProcessCompleted