FtpWebRequest.UseBinary Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

FtpWebRequest.cs

Obtém ou define um valor de Boolean que especifica o tipo de dados para as transferências de arquivos.

public:
 property bool UseBinary { bool get(); void set(bool value); };

public bool UseBinary { get; set; }

member this.UseBinary : bool with get, set

Public Property UseBinary As Boolean

Valor da propriedade

Boolean

true para indicar ao servidor que os dados a serem transferidos são binários; false para indicar que os dados são texto. O valor padrão é true.

Exceções

InvalidOperationException

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

Exemplos

O exemplo de código a seguir recupera e exibe valores de propriedade para um objeto especificado FtpWebRequest .

Console::WriteLine( "Passive: {0}  Keep alive: {1}  Binary: {2} Timeout: {3}.", request->UsePassive, request->KeepAlive, request->UseBinary, request->Timeout == -1 ? "none" : request->Timeout.ToString() );

Console.WriteLine("Passive: {0}  Keep alive: {1}  Binary: {2} Timeout: {3}.",
    request.UsePassive,
    request.KeepAlive,
    request.UseBinary,
    request.Timeout == -1 ? "none" : request.Timeout.ToString()
);

Comentários

Se você estiver enviando dados binários, como uma imagem, defina essa propriedade como true. Se você estiver enviando texto, defina a propriedade como false. Especificar true faz com que o FtpWebRequest envie um "TYPE I" comando para o servidor. Especificar false faz com que o FtpWebRequest envie um "Type A" comando para o servidor. Os servidores FTP podem ignorar esses comandos.

Alterar UseBinary depois de chamar o GetRequestStreammétodo , BeginGetRequestStreamGetResponse, ou BeginGetResponse causa uma exceçãoInvalidOperationException.

Confira também

• FtpWebResponse
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient