FtpWebResponse Klasse

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Quelle:

FtpWebResponse.cs

Kapselt die Antwort eines FTP-Servers (File Transfer Protocol) auf eine Anforderung.

public ref class FtpWebResponse : System::Net::WebResponse, IDisposable

public class FtpWebResponse : System.Net.WebResponse, IDisposable

type FtpWebResponse = class
    inherit WebResponse
    interface IDisposable

Public Class FtpWebResponse
Inherits WebResponse
Implements IDisposable

Vererbung

Object

MarshalByRefObject

WebResponse

FtpWebResponse

Implementiert

IDisposable

Beispiele

Das folgende Codebeispiel sendet eine Anforderung zum Löschen einer Datei auf einem FTP-Server und zeigt die Statusmeldung aus der Antwort des Servers auf die Anforderung an. Weitere Beispiele finden Sie in den Membern der WebRequestMethods.Ftp - und FtpWebRequest -Klasse.

static bool DeleteFileOnServer( Uri^ serverUri )
{
   // The serverUri parameter should use the ftp:// scheme.
   // It contains the name of the server file that is to be deleted.
   // Example: ftp://contoso.com/someFile.txt.
   // 
   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::DeleteFile;
   FtpWebResponse^ response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
   Console::WriteLine( "Delete status: {0}", response->StatusDescription );
   response->Close();
   return true;
}

public static bool DeleteFileOnServer(Uri serverUri)
{
    // The serverUri parameter should use the ftp:// scheme.
    // It contains the name of the server file that is to be deleted.
    // Example: ftp://contoso.com/someFile.txt.
    //

    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.DeleteFile;

    FtpWebResponse response = (FtpWebResponse) request.GetResponse();
    Console.WriteLine("Delete status: {0}",response.StatusDescription);
    response.Close();
    return true;
}

Hinweise

Instanzen von FtpWebResponse werden durch Aufrufen der GetResponse -Methode abgerufen. Das zurückgegebene Objekt muss in ein FtpWebResponseumgewandelt werden. Wenn Ihre Anwendung das FtpWebResponse -Objekt nicht mehr benötigt, rufen Sie die Close -Methode auf, um die ressourcen freizugeben, die FtpWebResponsevon gespeichert sind.

Die StatusCode -Eigenschaft enthält den vom Server zurückgegebenen Statuscode, und die StatusDescription -Eigenschaft gibt den Statuscode und eine Meldung zurück, die den Status beschreibt. Die von diesen Eigenschaften zurückgegebenen Werte ändern sich, wenn die Nachrichten vom Server zurückgegeben werden.

Alle von der Anforderung zurückgegebenen Daten, z. B. die Liste der für eine ListDirectory Anforderung zurückgegebenen Dateinamen, sind im von der GetResponseStream -Methode zurückgegebenen Stream verfügbar. Die Länge der Streamdaten kann aus der ContentLength -Eigenschaft abgerufen werden.

Eigenschaften

BannerMessage	Ruft die Meldung ab, die vom FTP-Server gesendet wird, wenn eine Verbindung vor der Anmeldung hergestellt wird.
ContentLength	Ruft die Länge der vom FTP-Server empfangenen Daten ab.
ContentType	Ruft beim Überschreiben in einer abgeleiteten Klasse den Inhaltstyp der empfangenen Daten ab oder legt diesen fest. (Geerbt von WebResponse)
ExitMessage	Ruft die vom Server am Ende einer FTP-Sitzung gesendete Meldung ab.
Headers	Ruft ein leeres WebHeaderCollection-Objekt ab.
IsFromCache	Ruft einen Boolean-Wert ab, der angibt, ob diese Antwort aus dem Cache abgerufen wurde. (Geerbt von WebResponse)
IsMutuallyAuthenticated	Ruft einen Boolean-Wert ab, der angibt, ob eine gegenseitige Authentifizierung erfolgt ist. (Geerbt von WebResponse)
LastModified	Ruft das Datum und die Uhrzeit der letzten Änderung einer Datei auf einem FTP-Server ab.
ResponseUri	Ruft den URI ab, der die Antwort auf die Anforderung gesendet hat.
StatusCode	Ruft den letzten vom FTP-Server gesendeten Statuscode ab.
StatusDescription	Ruft Text ab, der einen vom FTP-Server gesendeten Statuscode beschreibt.
SupportsHeaders	Ruft einen Wert ab, der angibt, ob die Headers-Eigenschaft von der FtpWebResponse-Instanz unterstützt wird.
WelcomeMessage	Ruft die Meldung ab, die der FTP-Server sendet, wenn die Authentifizierung abgeschlossen ist.

Methoden

Close()	Gibt die von der Antwort reservierten Ressourcen frei.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt die vom WebResponse-Objekt verwendeten nicht verwalteten Ressourcen frei. (Geerbt von WebResponse)
Dispose(Boolean)	Gibt die vom WebResponse-Objekt verwendeten nicht verwalteten Ressourcen und verwirft optional auch die verwalteten Ressourcen. (Geerbt von WebResponse)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Veraltet. Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind. (Geerbt von WebResponse)
GetResponseStream()	Ruft den Stream ab, der von einem FTP-Server gesendete Antwortdaten enthält.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Veraltet. Füllt eine SerializationInfo-Instanz mit den zum Serialisieren der WebResponse erforderlichen Daten auf. (Geerbt von WebResponse)

Weitere Informationen

• FtpWebRequest
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient