FtpWebResponse Klasa

Definicja

Hermetyzuje odpowiedź serwera protokół transferu plików (FTP) na żądanie.Encapsulates a File Transfer Protocol (FTP) server's response to a request.

public ref class FtpWebResponse : System::Net::WebResponse
public class FtpWebResponse : System.Net.WebResponse
type FtpWebResponse = class
    inherit WebResponse
Public Class FtpWebResponse
Inherits WebResponse
Dziedziczenie

Przykłady

Poniższy przykład kodu wysyła żądanie usunięcia pliku na serwerze FTP i wyświetla komunikat o stanie z odpowiedzi serwera na żądanie.The following code example sends a request to delete a file on an FTP server and displays the status message from the server's response to the request. Aby uzyskać więcej przykładów, zobacz elementy członkowskie klas WebRequestMethods.Ftp i FtpWebRequest.For additional examples, see the members of the WebRequestMethods.Ftp and FtpWebRequest classes.

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;
}

Uwagi

Wystąpienia FtpWebResponse są uzyskiwane przez wywołanie metody GetResponse.Instances of FtpWebResponse are obtained by calling the GetResponse method. Zwrócony obiekt musi być rzutowany do FtpWebResponse.The returned object must be cast to an FtpWebResponse. Gdy aplikacja nie potrzebuje już obiektu FtpWebResponse, wywołaj metodę Close, aby zwolnić zasoby przechowywane przez FtpWebResponse.When your application no longer needs the FtpWebResponse object, call the Close method to free the resources held by the FtpWebResponse.

Właściwość StatusCode zawiera kod stanu zwrócony przez serwer, a właściwość StatusDescription zwraca kod stanu i komunikat opisujący stan.The StatusCode property contains the status code returned by the server, and the StatusDescription property returns the status code and a message that describes the status. Wartości zwracane przez te właściwości zmieniają się w miarę zwracania komunikatów przez serwer.The values returned by these properties change as the messages are returned by the server.

Wszystkie dane zwrócone przez żądanie, takie jak lista nazw plików zwróconych dla żądania ListDirectory, są dostępne w strumieniu zwróconym przez metodę GetResponseStream.Any data returned by the request, such as the list of file names returned for a ListDirectory request, is available in the stream returned by the GetResponseStream method. Długość danych strumienia można uzyskać ze właściwości ContentLength.The length of the stream data can be obtained from the ContentLength property.

Właściwości

BannerMessage

Pobiera komunikat wysyłany przez serwer FTP, gdy połączenie zostanie nawiązane przed zalogowaniem się.Gets the message sent by the FTP server when a connection is established prior to logon.

ContentLength

Pobiera długość danych odebranych z serwera FTP.Gets the length of the data received from the FTP server.

ContentType

Zgłasza NotImplementedException we wszystkich przypadkach.Throws a NotImplementedException in all cases.

ExitMessage

Pobiera komunikat wysyłany przez serwer, gdy kończy się sesja FTP.Gets the message sent by the server when the FTP session is ending.

Headers

Pobiera pusty obiekt WebHeaderCollection.Gets an empty WebHeaderCollection object.

IsFromCache

Pobiera Boolean wartość wskazującą, czy ta odpowiedź została uzyskana z pamięci podręcznej.Gets a Boolean value that indicates whether this response was obtained from the cache.

(Odziedziczone po WebResponse)
IsMutuallyAuthenticated

Pobiera Boolean wartość wskazującą, czy wystąpił wzajemne uwierzytelnianie.Gets a Boolean value that indicates whether mutual authentication occurred.

(Odziedziczone po WebResponse)
LastModified

Pobiera datę i godzinę ostatniej modyfikacji pliku na serwerze FTP.Gets the date and time that a file on an FTP server was last modified.

ResponseUri

Pobiera identyfikator URI, który przesłał odpowiedź na żądanie.Gets the URI that sent the response to the request.

StatusCode

Pobiera najnowszy kod stanu wysłany z serwera FTP.Gets the most recent status code sent from the FTP server.

StatusDescription

Pobiera tekst opisujący kod stanu wysłany z serwera FTP.Gets text that describes a status code sent from the FTP server.

SupportsHeaders

Pobiera wartość wskazującą, czy właściwość Headers jest obsługiwana przez wystąpienie FtpWebResponse.Gets a value that indicates whether the Headers property is supported by the FtpWebResponse instance.

WelcomeMessage

Pobiera komunikat wysyłany przez serwer FTP po zakończeniu uwierzytelniania.Gets the message sent by the FTP server when authentication is complete.

Metody

Close()

Zwalnia zasoby przechowywane przez odpowiedź.Frees the resources held by the response.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia niezarządzane zasoby używane przez obiekt WebResponse.Releases the unmanaged resources used by the WebResponse object.

(Odziedziczone po WebResponse)
Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez obiekt WebResponse i opcjonalnie usuwa zarządzane zasoby.Releases the unmanaged resources used by the WebResponse object, and optionally disposes of the managed resources.

(Odziedziczone po WebResponse)
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

Wypełnia SerializationInfo danymi, które są konieczne do serializacji obiektu docelowego.Populates a SerializationInfo with the data that is needed to serialize the target object.

(Odziedziczone po WebResponse)
GetResponseStream()

Pobiera strumień zawierający dane odpowiedzi wysyłane z serwera FTP.Retrieves the stream that contains response data sent from an FTP server.

GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IDisposable.Dispose()

Gdy jest zastępowany w klasie pochodnej, zwalnia wszystkie zasoby używane przez WebResponse.When overridden in a derived class, releases all resources used by the WebResponse.

(Odziedziczone po WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Wypełnia wystąpienie SerializationInfo danymi, które są konieczne do serializacji WebResponse.Populates a SerializationInfo instance with the data that is needed to serialize WebResponse.

(Odziedziczone po WebResponse)

Dotyczy

Zobacz też