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 サーバーは、これらのコマンドを無視できます。

BeginGetRequestStream、、または BeginGetResponse メソッドを呼び出した後に GetRequestStreamを変更UseBinaryすると、例外がInvalidOperationException発生GetResponseします。

適用対象

こちらもご覧ください