Namespace:
Rebex.Net
Assembly:
Rebex.Ftp (in Rebex.Ftp.dll)
Syntax
Visual Basic |
---|
Public Function BeginGetNameList ( _ arguments As String, _ callback As AsyncCallback, _ state As Object _ ) As IAsyncResult |
C# |
---|
public IAsyncResult BeginGetNameList( string arguments, AsyncCallback callback, Object state ) |
Parameters
- arguments
- Type: System..::..String
Arguments for the NLST command.
- callback
- Type: System..::..AsyncCallback
An optional asynchronous callback to be called when the operation is complete.
- state
- Type: System..::..Object
A user-provided object that identifies this particular asynchronous operation.
Return Value
An IAsyncResult that references the asynchronous operation.Remarks
Represents FTP NLST command.
Actual behavior of NLST command varies from server to server, because the RFC is not clear in explaining what it should do. Some servers return the names of both files and directories, others return files only or even report error if the current directory is empty. Using GetList is a better choice in most cases.
Caution: The meaning of the arguments argument is not defined by RFC and varies from server to server. Some servers interpret it as parameters to ls command, some as a filename, some ignore it and some report an error. Calling this method with arguments other than null is not recommended and will make your code incompatible with many FTP servers.
In builds for .NET 4.0 and higher, this method is available as an extension method. Add 'using Rebex.Legacy' (C#) or 'Import Rebex.Legacy' (VB.NET) to your code in order to use it.