FtpWebRequest.Method Propriedade

  • Referência

Definição

Namespace:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
FtpWebRequest.cs
Origem:
FtpWebRequest.cs
Origem:
FtpWebRequest.cs

Obtém ou define o comando a ser enviado ao 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, set
Public Overrides Property Method As String

Valor da propriedade

String

Um valor String que contém o comando FTP a ser enviado ao servidor. O valor padrão é DownloadFile.

Exceções

InvalidOperationException

Um novo valor foi especificado para essa propriedade referente a uma solicitação já em andamento.

ArgumentException

O método é inválido.

- ou -

O método não tem suporte.

- ou -

Vários métodos foram especificados.

Exemplos

O exemplo de código a seguir define essa propriedade como 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;
}

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 como UploadFile, você deve fazer isso 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 StatusCode propriedades e StatusDescription .

Aplica-se a

Confira também