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