FtpWebRequest.Method Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Overrides Property Method As StringValeur 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 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 définit cette propriété sur DeleteFile.
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 la commande envoyée au serveur. Vous définissez l’utilisation Method 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 une autre valeur entraîne une ArgumentException exception.
Lorsque vous définissez MethodUploadFilela valeur , vous devez le faire avant d’appeler la GetRequestStream méthode. L’échec de l’appel de ces membres dans l’ordre correct provoque une ProtocolViolationException exception lorsque vous tentez d’obtenir le flux de requête.
Les informations d’identification fournies pour l’objet FtpWebRequest doivent avoir l’autorisation d’effectuer 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 propriétés et StatusDescription les StatusCode propriétés.
