FtpWebRequest.GetResponse Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die FTP-Serverantwort zurück.
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. Dieses Objekt enthält die Antwort des FTP-Servers auf die Anforderung.
Ausnahmen
GetResponse() oder BeginGetResponse(AsyncCallback, Object) wurde bereits für diese Instanz aufgerufen.
- oder -
Ein HTTP-Proxy ist aktiviert, und Sie haben versucht, einen anderen FTP-Befehl als DownloadFile, ListDirectory oder ListDirectoryDetails zu verwenden.
EnableSsl ist auf true
festgelegt, doch der Server unterstützt dieses Feature nicht.
- oder -
Eine Timeout-Eigenschaft wurde angegeben, und das Timeout ist abgelaufen.
Beispiele
Im folgenden Codebeispiel wird das Kopieren einer Datei in den Datenstrom einer Anforderung und das Senden einer Anforderung zum Anfügen von Daten an eine Datei an den Server veranschaulicht. Das Beispiel ruft auf GetResponse , um die Anforderung zu senden und zu blockieren, bis die Antwort vom Server zurückgegeben wird.
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 auf die FTP-spezifischen Eigenschaften zuzugreifen, müssen Sie das WebResponse von dieser Methode zurückgegebene Objekt in FtpWebResponseumwandeln.
GetResponse bewirkt, dass eine Steuerungsverbindung hergestellt wird und möglicherweise auch eine Datenverbindung erstellt wird. GetResponse blockiert, bis die Antwort empfangen wird. Um dies zu verhindern, können Sie diesen Vorgang asynchron ausführen, indem Sie die BeginGetResponse Methoden und EndGetResponse anstelle von GetResponseaufrufen.
Wenn die Proxy Eigenschaft entweder direkt oder in einer Konfigurationsdatei festgelegt ist, erfolgt die Kommunikation mit dem FTP-Server über den Proxy.
Wenn ein WebException ausgelöst wird, verwenden Sie die Response Eigenschaften und Status der Ausnahme, um die Antwort vom Server zu bestimmen.
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.
Hinweis
Mehrere Aufrufe, um GetResponse dasselbe Antwortobjekt zurückzugeben. Die Anforderung wird nicht erneut ausgestellt.
Hinweise für Aufrufer
Diese Methode generiert Netzwerkdatenverkehr.