FtpWebRequest.UseBinary Propriedade

Definição

Obtém ou define um valor de Boolean que especifica o tipo de dados para as transferências de arquivos.Gets or sets a Boolean value that specifies the data type for file transfers.

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.true to indicate to the server that the data to be transferred is binary; false to indicate that the data is text. O valor padrão é true.The default value is true.

Exceções

Um novo valor foi especificado para essa propriedade referente a uma solicitação já em andamento.A new value was specified for this property for a request that is already in progress.

Exemplos

O exemplo de código a seguir recupera e exibe valores de propriedade para um FtpWebRequest objeto especificado.The following code example retrieves and displays property values for a specified FtpWebRequest object.

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 .If you are sending binary data, such as an image, set this property to true. Se você estiver enviando texto, defina a propriedade como false .If you are sending text, set the property to false. Especificar true faz com que o FtpWebRequest envie um "TYPE I" comando para o servidor.Specifying true causes the FtpWebRequest to send a "TYPE I" command to the server. Especificar false faz com que o FtpWebRequest envie um "Type A" comando para o servidor.Specifying false causes the FtpWebRequest to send a "Type A" command to the server. Os servidores FTP podem ignorar esses comandos.FTP servers can ignore these commands.

Alterar UseBinary depois de chamar GetRequestStream o BeginGetRequestStream método,, GetResponse ou BeginGetResponse causa uma InvalidOperationException exceção.Changing UseBinary after calling the GetRequestStream, BeginGetRequestStream, GetResponse, or BeginGetResponse method causes an InvalidOperationException exception.

Aplica-se a

Confira também