FtpWebRequest.UseBinary 屬性
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定 Boolean 值，指定檔案傳輸的資料型別。
public:
property bool UseBinary { bool get(); void set(bool value); };C#
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() );
C#
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
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
