HttpResponse.WriteFile 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

将指定的文件直接写入 HTTP 响应输出流。

重载

WriteFile(IntPtr, Int64, Int64)	将指定的文件直接写入 HTTP 响应输出流。
WriteFile(String, Int64, Int64)	将指定的文件直接写入 HTTP 响应输出流。
WriteFile(String)	将指定文件的内容作为文件块直接写入 HTTP 响应输出流。
WriteFile(String, Boolean)	将指定文件的内容作为内存块直接写入 HTTP 响应输出流。

WriteFile(IntPtr, Int64, Int64)

将指定的文件直接写入 HTTP 响应输出流。

public:
 void WriteFile(IntPtr fileHandle, long offset, long size);

public void WriteFile (IntPtr fileHandle, long offset, long size);

member this.WriteFile : nativeint * int64 * int64 -> unit

Public Sub WriteFile (fileHandle As IntPtr, offset As Long, size As Long)

参数

fileHandle

IntPtr

nativeint

要写入 HTTP 输出流的文件的文件句柄。

offset

Int64

文件中将开始进行写入的字节位置。

size

Int64

要写入输出流的字节数。

例外

ArgumentNullException

fileHandler 上声明的默认值为 null。

HttpException

offset 小于 0。

• 或 -

size 大于文件大小与 offset 之差。

示例

以下示例将名为 (的 Login.txt 文本文件的所有内容写入输出流，该文件可能包含文本 HTML 文本和输入控件) 直接写入输出流。

String FileName;
 FileStream MyFileStream;
 IntPtr FileHandle;
 long StartPos = 0, FileSize;

 FileName = "c:\\temp\\Login.txt";

 MyFileStream = new FileStream(FileName, FileMode.Open);
 FileHandle = MyFileStream.Handle;
 FileSize = MyFileStream.Length;

 Response.Write("<b>Login: </b>");
 Response.Write("<input type=text id=user /> ");
 Response.Write("<input type=submit value=Submit /><br><br>");

 Response.WriteFile(FileHandle, StartPos, FileSize);

 MyFileStream.Close();

Dim FileName As String
Dim MyFileStream As FileStream
Dim FileHandle As IntPtr
Dim StartPos As Long = 0
Dim FileSize As Long

FileName = "c:\\temp\\Login.txt"

MyFileStream = New FileStream(FileName, FileMode.Open)
FileHandle = MyFileStream.Handle
FileSize = MyFileStream.Length

Response.Write("<b>Login: </b>")
Response.Write("<input type=text id=user /> ")
Response.Write("<input type=submit value=Submit /><br><br>")

Response.WriteFile(FileHandle, StartPos, FileSize)
   
MyFileStream.Close()

注解

当此方法与大型文件一起使用时，调用该方法可能会引发异常。 可用于此方法的文件的大小取决于 Web 服务器的硬件配置。

WriteFile(String, Int64, Int64)

将指定的文件直接写入 HTTP 响应输出流。

public:
 void WriteFile(System::String ^ filename, long offset, long size);

public void WriteFile (string filename, long offset, long size);

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

Public Sub WriteFile (filename As String, offset As Long, size As Long)

参数

filename

String

要写入 HTTP 输出流的文件名。

offset

Int64

文件中将开始进行写入的字节位置。

size

Int64

要写入输出流的字节数。

例外

HttpException

offset 小于 0。

• 或 -

size 大于文件大小与 offset 之差。

ArgumentNullException

filename 参数为 null。

示例

以下示例将名为 (的 Login.txt 文本文件的所有内容写入输出流，该文件可能包含文本文本和 HTML 输入控件) 直接写入输出流。

String FileName;
 FileInfo MyFileInfo;
 long StartPos = 0, FileSize;

 FileName = "c:\\temp\\login.txt";
 MyFileInfo = new FileInfo(FileName);
 FileSize = MyFileInfo.Length;

 Response.Write("Please Login: <br>");
 Response.WriteFile(FileName, StartPos, FileSize);

Dim FileName As String
 Dim MyFileInfo As FileInfo
 Dim StartPos, FileSize As Long
 
 FileName = "c:\\temp\\login.txt"
 MyFileInfo = New FileInfo(FileName)
 FileSize = MyFileInfo.Length 
 
 Response.Write("Please Login: <br>")
 Response.WriteFile(FileName, StartPos, FileSize)
    

注解

当此方法与大型文件一起使用时，调用该方法可能会引发异常。 可用于此方法的文件的大小取决于 Web 服务器的硬件配置。

WriteFile(String)

将指定文件的内容作为文件块直接写入 HTTP 响应输出流。

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

public void WriteFile (string filename);

member this.WriteFile : string -> unit

Public Sub WriteFile (filename As String)

参数

filename

String

要写入 HTTP 输出的文件名。

例外

ArgumentNullException

filename 参数为 null。

示例

以下示例将名为 (的 Login.txt 文本文件的所有内容写入输出流，该文件可能包含文本 HTML 文本和输入控件) 直接写入输出流。

Response.Write("Please Login: <br>");
 Response.WriteFile("login.txt");

Response.Write("Please Login: <br>")
 Response.WriteFile("login.txt")
    

注解

当此方法与大型文件一起使用时，调用该方法可能会引发异常。 可用于此方法的文件的大小取决于 Web 服务器的硬件配置。

WriteFile(String, Boolean)

将指定文件的内容作为内存块直接写入 HTTP 响应输出流。

public:
 void WriteFile(System::String ^ filename, bool readIntoMemory);

public void WriteFile (string filename, bool readIntoMemory);

member this.WriteFile : string * bool -> unit

Public Sub WriteFile (filename As String, readIntoMemory As Boolean)

参数

filename

String

要写入内存块的文件名。

readIntoMemory

Boolean

指示是否将把文件写入内存块。

例外

ArgumentNullException

filename 参数为 null。

示例

以下示例将文件写入内存。

Response.WriteFile("login.txt", true);

Response.WriteFile("login.txt", True)
    

注解

当此方法与大型文件一起使用时，调用该方法可能会引发异常。 可用于此方法的文件的大小取决于 Web 服务器的硬件配置。