HttpResponse.TransmitFile 方法

参考

定义

命名空间:: System.Web

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将指定的文件直接写入 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

不支持进程外辅助请求。

或 -

响应不使用 HttpWriter 对象。

ArgumentException

offset 参数小于零或大于文件大小。

或 -

length 参数小于 -1 或大于 offset 参数加上文件大小的值。

注解

如果将 0 指定为 offset 参数，并将 -1 指定为 length 参数，则会发送整个文件。

适用于

TransmitFile(String)