FtpWebRequest.GetResponse Método

Definición

Devuelve la respuesta del servidor 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

Devoluciones

WebResponse

Referencia a WebResponse que contiene una instancia de FtpWebResponse.A WebResponse reference that contains an FtpWebResponse instance. Este objeto contiene la respuesta del servidor FTP a la solicitud.This object contains the FTP server's response to the request.

Excepciones

Ya se ha llamado a GetResponse() o BeginGetResponse(AsyncCallback, Object) para esta instancia.GetResponse() or BeginGetResponse(AsyncCallback, Object) has already been called for this instance.

o bien-or- Está habilitado un proxy HTTP y se ha intentado utilizar un comando FTP distinto de DownloadFile, ListDirectory o ListDirectoryDetails.An HTTP proxy is enabled, and you attempted to use an FTP command other than DownloadFile, ListDirectory, or ListDirectoryDetails.

EnableSsl está establecida en true, pero el servidor no admite esta característica.EnableSsl is set to true, but the server does not support this feature.

o bien-or- Se especificó Timeout y el tiempo de espera ha expirado.A Timeout was specified and the timeout has expired.

Ejemplos

En el ejemplo de código siguiente se muestra cómo copiar un archivo en el flujo de datos de una solicitud y enviar una solicitud para anexar datos a un archivo en el servidor.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. El ejemplo llama GetResponse a para enviar la solicitud y bloquear hasta que el servidor devuelva la respuesta.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;
}

Comentarios

Para tener acceso a las propiedades específicas de FTP, debe convertir el WebResponse objeto devuelto por este método en FtpWebResponse .To access the FTP-specific properties, you must cast the WebResponse object returned by this method to FtpWebResponse.

GetResponse hace que se establezca una conexión de control y también puede crear una conexión de datos.GetResponse causes a control connection to be established, and might also create a data connection. GetResponse se bloquea hasta que se recibe la respuesta.GetResponse blocks until the response is received. Para evitarlo, puede realizar esta operación de forma asincrónica mediante una llamada a los BeginGetResponse EndGetResponse métodos y en lugar de GetResponse .To prevent this, you can perform this operation asynchronously by calling the BeginGetResponse and EndGetResponse methods in place of GetResponse.

Si Proxy se establece la propiedad, ya sea directamente o en un archivo de configuración, las comunicaciones con el servidor FTP se realizan a través del proxy.If the Proxy property is set, either directly or in a configuration file, communications with the FTP server are made through the proxy.

Si WebException se produce una, utilice las Response Status propiedades y de la excepción para determinar la respuesta del servidor.If a WebException is thrown, use the Response and Status properties of the exception to determine the response from the server.

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación.This member outputs trace information when you enable network tracing in your application. Para obtener más información, consulte seguimiento de red en el .NET Framework.For more information, see Network Tracing in the .NET Framework.

Nota

Varias llamadas para GetResponse devolver el mismo objeto de respuesta; no se vuelve a emitir la solicitud.Multiple calls to GetResponse return the same response object; the request is not reissued.

Notas a los autores de las llamadas

Este método genera tráfico de red.This method generates network traffic.

Se aplica a

Consulte también