SendFileToUniqueName(Stream) Method

Sends the data from the specified System.IO.Stream to the FTP server's current working folder and stores it using a unique filename.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function SendFileToUniqueName( _
   ByVal source As Stream _
) As String

'Usage
 
Dim instance As FtpClient
Dim source As Stream
Dim value As String
 
value = instance.SendFileToUniqueName(source)

public string SendFileToUniqueName( 
   Stream source
)

Parameters

source: A System.IO.Stream whose data is to be sent to the FTP server.

Return Value

A string representing the unique name that was generated for the file that was sent to the FTP server.

Exceptions

Exception	Description
FtpInvalidStateException	Cannot perform the requested operation because the FTP client is in an invalid state.
FtpReplyException	An error reply was returned by the FTP server.
FtpIOException	An I/O error has occurred.
FtpInternalException	A fatal FTP-specific error has occurred..

Remarks

The file will be sent to the current working folder. If you want to send the file to another location, you could use the ChangeCurrentFolder and/or ChangeToParentFolder methods to change the current working folder.

The current working folder can be retrieved via the GetCurrentFolder method.

When using this overload of the SendFileToUniqueName method, in the SendingFile event, the TransferringFileEventArgs.LocalFilename property will be System.String.Empty. This overload will also ignore the value of the PreAllocateStorage property.

The SendFileToUniqueName method will send the STOU and PASV or PORT commands and optionally the TYPE command to the FTP server.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

FtpClient Class
FtpClient Members
Overload List