FtpWebRequest.GetResponse FtpWebRequest.GetResponse FtpWebRequest.GetResponse FtpWebRequest.GetResponse Method

Definition

Gibt die FTP-Serverantwort zurück.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

Gibt zurück

Ein WebResponse-Verweis, der eine FtpWebResponse-Instanz enthält.A WebResponse reference that contains an FtpWebResponse instance. Dieses Objekt enthält die Antwort des FTP-Servers auf die Anforderung.This object contains the FTP server's response to the request.

Ausnahmen

GetResponse() oder BeginGetResponse(AsyncCallback, Object) wurde bereits für diese Instanz aufgerufen.GetResponse() or BeginGetResponse(AsyncCallback, Object) has already been called for this instance.

- oder --or- Ein HTTP-Proxy ist aktiviert, und Sie haben versucht, einen anderen FTP-Befehl als DownloadFile, ListDirectory oder ListDirectoryDetails zu verwenden.An HTTP proxy is enabled, and you attempted to use an FTP command other than DownloadFile, ListDirectory, or ListDirectoryDetails.

EnableSsl ist auf true festgelegt, doch der Server unterstützt dieses Feature nicht.EnableSsl is set to true, but the server does not support this feature.

- oder --or- Eine Timeout-Eigenschaft wurde angegeben, und das Timeout ist abgelaufen.A Timeout was specified and the timeout has expired.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, eine Datei in einer Anforderung Datenstrom kopieren und sendet eine Anforderung an die Daten in eine Datei an den Server angefügt werden sollen.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. Das Beispiel ruft GetResponse Anforderung senden und zu blockieren, bis die Antwort vom Server zurückgegeben wird.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;
}

Hinweise

Um die FTP-spezifischen Eigenschaften zuzugreifen, müssen Sie eine Umwandlung der WebResponse von dieser Methode zurückgegebene Objekt FtpWebResponse.To access the FTP-specific properties, you must cast the WebResponse object returned by this method to FtpWebResponse.

GetResponse bewirkt, dass eine Steuerelement Verbindung hergestellt werden, und Sie können auch eine Datenverbindung erstellen.GetResponse causes a control connection to be established, and might also create a data connection. GetResponse blockiert, bis die Antwort empfangen wird.GetResponse blocks until the response is received. Um dies zu verhindern, Sie können diesen Vorgang ausführen asynchron durch Aufrufen der BeginGetResponse und EndGetResponse Methoden anstelle von GetResponse.To prevent this, you can perform this operation asynchronously by calling the BeginGetResponse and EndGetResponse methods in place of GetResponse.

Wenn die Proxy Eigenschaft festgelegt ist, entweder direkt oder in einer Konfigurationsdatei erfolgen die Kommunikation mit dem FTP-Server über den Proxy.If the Proxy property is set, either directly or in a configuration file, communications with the FTP server are made through the proxy.

Wenn eine WebException ist ausgelöst wird, verwenden die Response und Status Eigenschaften der Ausnahme, um die Antwort vom Server zu bestimmen.If a WebException is thrown, use the Response and Status properties of the exception to determine the response from the server.

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Hinweis

Mehrere Aufrufe GetResponse desselben Objekts Antwort zurückgegeben wird die Anforderung nicht erneut gesendet.Multiple calls to GetResponse return the same response object; the request is not reissued.

Hinweise für Aufrufer

Diese Methode wird der Netzwerkverkehr generiert.This method generates network traffic.

Gilt für:

Siehe auch