FtpWebRequest.Method Eigenschaft

Definition

Ruft den an den FTP-Server zu sendenden Befehl ab oder legt diesen fest.

public:
 virtual property System::String ^ Method { System::String ^ get(); void set(System::String ^ value); };
public override string Method { get; set; }
member this.Method : string with get, set
Public Overrides Property Method As String

Eigenschaftswert

Ein String-Wert, der den an den Server zu sendenden FTP-Befehl enthält. Der Standardwert ist DownloadFile.

Ausnahmen

Für diese Eigenschaft wurde ein neuer Wert für eine Anforderung angegeben, die bereits ausgeführt wird.

Die Methode ist ungültig.

- oder -

Die Methode wird nicht unterstützt.

- oder -

Es wurden mehrere Methoden angegeben.

Beispiele

Im folgenden Codebeispiel wird diese Eigenschaft auf DeleteFilefestgelegt.

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

Die Method -Eigenschaft bestimmt, welcher Befehl an den Server gesendet wird. Legen Sie die Method mithilfe der Zeichenfolgen fest, die in den öffentlichen Feldmembern der WebRequestMethods.Ftp -Klasse definiert sind. Beachten Sie, dass die in der WebRequestMethods.Ftp -Klasse definierten Zeichenfolgen die einzigen unterstützten Optionen für die Method -Eigenschaft sind. Das Festlegen der Method Eigenschaft auf einen anderen Wert führt zu einer ArgumentException Ausnahme.

Wenn Sie auf UploadFilefestlegenMethod, müssen Sie dies vor dem Aufrufen der GetRequestStream -Methode tun. Wenn Sie diese Member nicht in der richtigen Reihenfolge aufrufen, wird eine ProtocolViolationException Ausnahme ausgelöst, wenn Sie versuchen, den Anforderungsdatenstrom abzurufen.

Die für das FtpWebRequest Objekt angegebenen Anmeldeinformationen müssen über die Berechtigung zum Ausführen der angegebenen Methode verfügen. Andernfalls schlägt der FTP-Befehl fehl.

Überprüfen Sie StatusCode die Eigenschaften und StatusDescription , um den Erfolg oder Fehler eines Befehls zu ermitteln.

Gilt für:

Weitere Informationen