FtpWebRequest.UseBinary Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение Boolean, которое указывает тип данных для передачи файлов.
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
Значение свойства
Значение true
, чтобы указать серверу, что передаваемые данные являются двоичными; значение false
, чтобы указать на передачу текстовых данных. Значение по умолчанию — true
.
Исключения
Для этого свойства задано новое значение для уже выполняющегося запроса.
Примеры
В следующем примере кода извлекаются и отображаются значения свойств для указанного 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()
);
Комментарии
Если вы отправляете двоичные данные, например изображение, задайте для этого свойства значение true
. Если вы отправляете текст, задайте для свойства значение false
. Указание true
приводит к отправке FtpWebRequest"TYPE I"
команды на сервер. Указание false
приводит к отправке FtpWebRequest"Type A"
команды на сервер. FTP-серверы могут игнорировать эти команды.
Изменение UseBinary после вызова GetRequestStreamметода , BeginGetRequestStream, GetResponseили BeginGetResponse вызывает InvalidOperationException исключение.