FtpWebRequest.UseBinary プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ファイル転送のデータ型を指定する Boolean 値を取得または設定します。
public:
property bool UseBinary { bool get(); void set(bool value); };public bool UseBinary { get; set; }member this.UseBinary : bool with get, setPublic 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()
);
注釈
画像などのバイナリ データを送信する場合は、このプロパティを true に設定します。 テキストを送信する場合は、プロパティを false に設定します。
trueを指定すると、FtpWebRequestは "TYPE I" コマンドをサーバーに送信します。
falseを指定すると、FtpWebRequestは "Type A" コマンドをサーバーに送信します。 FTP サーバーは、これらのコマンドを無視できます。
UseBinary、GetRequestStream、BeginGetRequestStream、または GetResponse メソッドを呼び出した後にBeginGetResponseを変更すると、InvalidOperationException例外が発生します。