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 會導致 InvalidOperationException 例外狀況。 BeginGetResponseGetResponseBeginGetRequestStreamGetRequestStream

適用於

另請參閱