Export (0) Print
Expand All

FtpWebRequest.GetRequestStream Method

Retrieves the stream used to upload data to an FTP server.

Namespace:  System.Net
Assembly:  System (in System.dll)

abstract GetRequestStream : unit -> Stream 
override GetRequestStream : unit -> Stream 

Return Value

Type: System.IO.Stream
A writable Stream instance used to store data to be sent to the server by the current request.

ExceptionCondition
InvalidOperationException

BeginGetRequestStream has been called and has not completed.

- or -

An HTTP proxy is enabled, and you attempted to use an FTP command other than WebRequestMethods.Ftp.DownloadFile, WebRequestMethods.Ftp.ListDirectory, or WebRequestMethods.Ftp.ListDirectoryDetails.

WebException

A connection to the FTP server could not be established.

ProtocolViolationException

The Method property is not set to WebRequestMethods.Ftp.UploadFile or WebRequestMethods.Ftp.AppendFile.

Set the request properties before calling the GetRequestStream method. After writing the data to the stream, you must close the stream prior to sending the request.

If you have not set the Method property to UploadFile or AppendFile, you cannot get the stream.

GetRequestStream blocks while waiting for the stream. To prevent this, call the BeginGetRequestStream method in place of GetRequestStream.

NoteNote

This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

Notes to Callers

This method generates network traffic.

The following code example demonstrates copying a file to a request's data stream and sending a request to the server to upload the data and append it to a file.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft