FtpWebResponse Klasse

Definition

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

public ref class FtpWebResponse : System::Net::WebResponse, IDisposable
public ref class FtpWebResponse : System::Net::WebResponse
public class FtpWebResponse : System.Net.WebResponse, IDisposable
public class FtpWebResponse : System.Net.WebResponse
type FtpWebResponse = class
    inherit WebResponse
    interface IDisposable
Public Class FtpWebResponse
Inherits WebResponse
Implements IDisposable
Public Class FtpWebResponse
Inherits WebResponse
Vererbung
Implementiert

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

Löst in allen Fällen eine NotImplementedException aus.

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.

SupportsHeaders

Ruft einen Wert ab, der angibt, ob Header unterstützt werden.

(Geerbt von WebResponse)
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

IDisposable.Dispose()

Gibt beim Überschreiben in einer abgeleiteten Klasse alle von der WebResponse verwendeten Ressourcen frei.

(Geerbt von WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)
Veraltet.

Füllt eine SerializationInfo-Instanz mit den zum Serialisieren der WebResponse erforderlichen Daten auf.

(Geerbt von WebResponse)

Gilt für:

Weitere Informationen