FtpWebRequest.Method Propriété

Définition

Obtient ou définit la commande à envoyer au serveur FTP.

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

Une nouvelle valeur a été spécifiée pour cette propriété pour une demande qui est déjà en cours.

La méthode n'est pas valide.

- ou -

La méthode n'est pas prise en charge.

- ou -

Plusieurs méthodes ont été spécifiées.

Exemples

L’exemple de code suivant affecte à cette propriété la valeur 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 en Method utilisant les 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é . Si vous affectez à la Method propriété une autre valeur, une ArgumentException exception est générée.

Lorsque vous définissez Method sur UploadFile, vous devez le faire avant d’appeler la GetRequestStream méthode . Le fait de ne pas appeler ces membres dans le bon ordre provoque une ProtocolViolationException exception 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, vérifiez les StatusCode propriétés et StatusDescription .

S’applique à

Voir aussi