FtpWebRequest.Method Propriété

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

Valeur de propriété

Valeur String qui contient la commande FTP à envoyer au serveur. La valeur par défaut est DownloadFile.

Exceptions

Exemples

L’exemple de code suivant définit cette propriété sur DeleteFile.

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

Remarques

La Method propriété détermine quelle commande est envoyée au serveur. Vous définissez le Method à l’aide des chaînes définies dans les membres de champ public de la WebRequestMethods.Ftp classe . Notez que les chaînes définies dans la WebRequestMethods.Ftp classe sont les seules options prises en charge pour la Method propriété . La définition de la Method propriété sur n’importe quelle autre valeur entraîne une ArgumentException exception.

Lorsque vous définissez Method sur UploadFile, vous devez le faire avant d’appeler la GetRequestStream méthode . Si vous n’appelez pas ces membres dans l’ordre correct, une ProtocolViolationException exception est générée lorsque vous tentez d’obtenir le flux de demande.

Les informations d’identification fournies pour l’objet FtpWebRequest doivent être autorisées à exécuter la méthode spécifiée. Si ce n’est pas le cas, la commande FTP échoue.

Pour déterminer la réussite ou l’échec d’une commande, case activée les StatusCode propriétés etStatusDescription.

S’applique à

Voir aussi

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