FtpWebRequest.Method Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o comando a ser enviado para o servidor 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 StringValor da propriedade
Um String valor que contém o comando FTP a ser enviado para o servidor. O valor padrão é DownloadFile.
Exceções
Um novo valor foi especificado para essa propriedade para uma solicitação que já está em andamento.
O método é inválido.
- ou -
Não há suporte para o método.
- ou -
Vários métodos foram especificados.
Exemplos
O exemplo de código a seguir define essa propriedade como 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;
}
Comentários
A Method propriedade determina qual comando é enviado ao servidor. Você define o Method usando as cadeias de caracteres definidas nos membros do campo público da WebRequestMethods.Ftp classe. Observe que as cadeias de caracteres definidas na WebRequestMethods.Ftp classe são as únicas opções com suporte para a Method propriedade. Definir a Method propriedade como qualquer outro valor resultará em uma exceção ArgumentException .
Ao definir Method para UploadFile, você deve fazê-lo antes de chamar o GetRequestStream método. A falha ao chamar esses membros na ordem correta causa uma ProtocolViolationException exceção quando você tenta obter o fluxo de solicitação.
As credenciais fornecidas para o FtpWebRequest objeto devem ter permissão para executar o método especificado. Caso contrário, o comando FTP falhará.
Para determinar o êxito ou a falha de um comando, verifique as propriedades e StatusDescription as StatusCode propriedades.
