Partager via

FtpWebRequest.Method Propriété

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
FtpWebRequest.cs
Source:
FtpWebRequest.cs
Source:
FtpWebRequest.cs

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é

String

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

Exceptions

InvalidOperationException

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

ArgumentException

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