Export (0) Print
Expand All

FtpWebRequest::GetResponse Method

Returns the FTP server response.

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

public:
virtual WebResponse^ GetResponse() override

Return Value

Type: System.Net::WebResponse
A WebResponse reference that contains an FtpWebResponse instance. This object contains the FTP server's response to the request.

ExceptionCondition
InvalidOperationException

GetResponse or BeginGetResponse has already been called for this instance.

- 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

EnableSsl is set to true, but the server does not support this feature.

- or -

A Timeout was specified and the timeout has expired.

To access the FTP-specific properties, you must cast the WebResponse object returned by this method to FtpWebResponse.

GetResponse causes a control connection to be established, and might also create a data connection. GetResponse blocks until the response is received. To prevent this, you can perform this operation asynchronously by calling the BeginGetResponse and EndGetResponse methods in place of GetResponse.

If the Proxy property is set, either directly or in a configuration file, communications with the FTP server are made through the proxy.

If a WebException is thrown, use the Response and Status properties of the exception to determine the response from the server.

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

NoteNote

Multiple calls to GetResponse return the same response object; the request is not reissued.

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 append data to a file to the server. The example calls GetResponse to send the request and block until the response is returned by the server.

static bool AppendFileOnServer( String^ fileName, Uri^ serverUri )
{
   // The URI described by serverUri should use the ftp:// scheme. 
   // It contains the name of the file on the server. 
   // Example: ftp://contoso.com/someFile.txt.  
   // The fileName parameter identifies the file containing  
   // the data to be appended to the file on the server. 
   if ( serverUri->Scheme != Uri::UriSchemeFtp )
   {
      return false;
   }

   // Get the object used to communicate with the server.
   FtpWebRequest^ request = dynamic_cast<FtpWebRequest^>(WebRequest::Create( serverUri ));
   request->Method = WebRequestMethods::Ftp::AppendFile;
   StreamReader^ sourceStream = gcnew StreamReader( fileName );
   array<Byte>^fileContents = Encoding::UTF8->GetBytes( sourceStream->ReadToEnd() );
   sourceStream->Close();
   request->ContentLength = fileContents->Length;

   // This example assumes the FTP site uses anonymous logon.
   request->Credentials = gcnew NetworkCredential( "anonymous","janeDoe@contoso.com" );
   Stream^ requestStream = request->GetRequestStream();
   requestStream->Write( fileContents, 0, fileContents->Length );
   requestStream->Close();
   FtpWebResponse^ response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
   Console::WriteLine( "Append status: {0}", response->StatusDescription );
   response->Close();
   return true;
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft