This documentation is archived and is not being maintained.

HttpResponse.WriteFile Method (String, Int64, Int64)

.NET Framework 1.1

Writes the specified file directly to an HTTP content output stream.

[Visual Basic]
Overloads Public Sub WriteFile( _
   ByVal filename As String, _
   ByVal offset As Long, _
   ByVal size As Long _
)
[C#]
public void WriteFile(
 string filename,
 long offset,
 long size
);
[C++]
public: void WriteFile(
 String* filename,
 __int64 offset,
 __int64 size
);
[JScript]
public function WriteFile(
   filename : String,
 offset : long,
 size : long
);

Parameters

filename
The name of the file to write to the HTTP output stream.
offset
The byte position in the file where writing will start.
size
The number of bytes to write to the output stream.

Example

The following example writes the entire contents of a text file named "login.txt" (which might contain literal text and HTML input controls) directly to the output stream.

[Visual Basic] 
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)
    

[C#] 
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);
    

[C++] 
String* FileName;
 FileInfo* MyFileInfo;
 __int64 StartPos = 0, FileSize;
 
 FileName = S"c:\\temp\\login.txt";
 MyFileInfo = new FileInfo(FileName);
 FileSize = MyFileInfo->Length;
 
 Response->Write(S"Please Login: <br>");
 Response->WriteFile(FileName, StartPos, FileSize);
    

[JScript] 
var fileName : String
var myFileInfo : FileInfo
var startPos : long = 0
var fileSize : long

fileName = "c:\\temp\\login.txt"
myFileInfo = new FileInfo(fileName)
fileSize = myFileInfo.Length 

Response.Write("Please Login: <br>")
Response.WriteFile(fileName, startPos, fileSize)

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

HttpResponse Class | HttpResponse Members | System.Web Namespace | HttpResponse.WriteFile Overload List

Show: