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. Sie legen 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. Fehler beim Aufrufen dieser Member in der richtigen Reihenfolge führt zu einer ProtocolViolationException Ausnahme, wenn Sie versuchen, den Anforderungsstream 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.

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

Gilt für:

Weitere Informationen