HttpResponse.TransmitFile 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

將指定的檔案直接寫入 HTTP 回應輸出資料流，而不在記憶體中緩衝。

多載

TransmitFile(String, Int64, Int64)	將指定的檔案部分直接寫入 HTTP 回應輸出資料流，而不在記憶體中緩衝。
TransmitFile(String)	將指定的檔案直接寫入 HTTP 回應輸出資料流，而不在記憶體中緩衝。

TransmitFile(String, Int64, Int64)

將指定的檔案部分直接寫入 HTTP 回應輸出資料流，而不在記憶體中緩衝。

public:
 void TransmitFile(System::String ^ filename, long offset, long length);

public void TransmitFile (string filename, long offset, long length);

member this.TransmitFile : string * int64 * int64 -> unit

Public Sub TransmitFile (filename As String, offset As Long, length As Long)

參數

filename

String

要寫入 HTTP 輸出的檔案名稱。

offset

Int64

開始寫入 HTTP 輸出的檔案位置。

length

Int64

要傳送的位元組數目。

例外狀況

ArgumentNullException

offset 參數小於零。

-或-

length 參數小於 -1。

-或-

length 參數指定大於檔案包含之位元組數目減去位移的位元組數目。

PlatformNotSupportedException

不支援跨處理序 (Out-Of-Process) 背景工作要求。

-或-

回應並未使用 HttpWriter 物件。

ArgumentException

offset 參數小於零或大於檔案大小。

-或-

length 參數小於 1，或大於 offset 參數加上檔案大小的值。

備註

如果您將 0 指定為 offset 參數，並將 -1 指定為 length 參數，則會傳送整個檔案。

TransmitFile(String)

將指定的檔案直接寫入 HTTP 回應輸出資料流，而不在記憶體中緩衝。

public:
 void TransmitFile(System::String ^ filename);

public void TransmitFile (string filename);

member this.TransmitFile : string -> unit

Public Sub TransmitFile (filename As String)

參數

filename

String

要寫入 HTTP 輸出的檔案名稱。

例外狀況

ArgumentNullException

filename 參數為 null。