FtpWebRequest.GetResponse Метод

Определение

Возвращает ответ FTP-сервера.Returns the FTP server response.

public:
 override System::Net::WebResponse ^ GetResponse();
public override System.Net.WebResponse GetResponse ();
override this.GetResponse : unit -> System.Net.WebResponse
Public Overrides Function GetResponse () As WebResponse

Возвращаемое значение

Ссылка WebResponse, которая содержит экземпляр FtpWebResponse.A WebResponse reference that contains an FtpWebResponse instance. Этот объект содержит ответ FTP-сервера на запрос.This object contains the FTP server's response to the request.

Исключения

GetResponse() или BeginGetResponse(AsyncCallback, Object) уже был вызван для этого экземпляра.GetResponse() or BeginGetResponse(AsyncCallback, Object) has already been called for this instance.

-или--or- Прокси-сервер HTTP включен, и была предпринята попытка использования FTP-команды, отличной от DownloadFile, ListDirectory или ListDirectoryDetails.An HTTP proxy is enabled, and you attempted to use an FTP command other than DownloadFile, ListDirectory, or ListDirectoryDetails.

Значение свойства EnableSsl равно true, однако сервер не поддерживает эту функциональную возможность.EnableSsl is set to true, but the server does not support this feature.

-или--or- Срок ожидания Timeout был указан и истек.A Timeout was specified and the timeout has expired.

Примеры

В следующем примере кода показано копирование файла в поток данных запроса и отправка запроса на добавление данных в файл на сервер.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. В примере вызывается GetResponse для отправки запроса и блокировки до тех пор, пока сервер не вернет ответ.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;
}
       public 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 = (FtpWebRequest)WebRequest.Create(serverUri);
           request.Method = WebRequestMethods.Ftp.AppendFile;
           
           StreamReader sourceStream = new StreamReader(fileName);
           byte [] fileContents = Encoding.UTF8.GetBytes(sourceStream.ReadToEnd());
           sourceStream.Close();
           request.ContentLength = fileContents.Length;

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

Комментарии

Для доступа к свойствам, относящимся к FTP, необходимо привести объект WebResponse, возвращаемый этим методом, в FtpWebResponse.To access the FTP-specific properties, you must cast the WebResponse object returned by this method to FtpWebResponse.

GetResponse устанавливает подключение элемента управления и может также создать подключение к данным.GetResponse causes a control connection to be established, and might also create a data connection. GetResponse блокируется до получения ответа.GetResponse blocks until the response is received. Чтобы избежать этого, эту операцию можно выполнить асинхронно, вызвав методы BeginGetResponse и EndGetResponse вместо GetResponse.To prevent this, you can perform this operation asynchronously by calling the BeginGetResponse and EndGetResponse methods in place of GetResponse.

Если свойство Proxy задано напрямую или в файле конфигурации, взаимодействие с FTP-сервером осуществляется через прокси-сервер.If the Proxy property is set, either directly or in a configuration file, communications with the FTP server are made through the proxy.

При появлении WebException используйте свойства Response и Status исключения, чтобы определить ответ от сервера.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. Дополнительные сведения см. в разделе Сетевая трассировка в .NET Framework.For more information, see Network Tracing in the .NET Framework.

Примечание

Несколько вызовов GetResponse возвращают один и тот же объект ответа. запрос не выдается повторно.Multiple calls to GetResponse return the same response object; the request is not reissued.

Примечания для тех, кто вызывает этот метод

Этот метод создает сетевой трафик.This method generates network traffic.

Применяется к

Дополнительно