FtpWebRequest.Method Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define o comando para enviar 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 de Propriedade
Um String valor que contém o comando FTP para enviar ao servidor. O valor predefinido é DownloadFile.
Exceções
Foi especificado um novo valor para esta propriedade para um pedido que já está em curso.
O método é inválido.
-ou-
O método não é suportado.
-ou-
Foram especificados vários métodos.
Exemplos
O seguinte exemplo de código define esta 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;
}
Observações
A Method propriedade determina qual o comando enviado ao servidor. Define o Method usando as strings definidas nos membros do campo público da WebRequestMethods.Ftp classe. Note que as cadeias definidas na WebRequestMethods.Ftp classe são as únicas opções suportadas para a Method propriedade. Definir a Method propriedade para qualquer outro valor resultará numa ArgumentException exceção.
Ao definir Method para UploadFile, deve fazê-lo antes de chamar o GetRequestStream método. A falha em chamar estes membros na ordem correta causa uma ProtocolViolationException exceção quando tenta obter o fluxo de pedidos.
As credenciais fornecidas para o FtpWebRequest objeto devem ter permissão para executar o método especificado. Se não, o comando FTP falha.
Para determinar o sucesso ou fracasso de um comando, verifique as StatusCode propriedades e.StatusDescription
