This documentation is archived and is not being maintained.

HttpResponse.WriteFile Method (IntPtr, Int64, Int64)

.NET Framework 1.1

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

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

Parameters

fileHandle
The file handle 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 HTML text and input controls) directly to the output stream.

[Visual Basic] 
Dim MyFileStream As FileStream
 Dim FileName As String
 Dim FileHandle As IntPtr
 Dim StartPos As Long = 0, 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()
    

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

[C++] 
String* FileName;
 FileStream* MyFileStream;
 IntPtr FileHandle;
 __int64 StartPos = 0, FileSize;
 
 FileName = S"c:\\temp\\Login.txt";
 
 MyFileStream = new FileStream(FileName, FileMode::Open);
 FileHandle = MyFileStream->Handle;
 FileSize = MyFileStream->Length;
 
 Response->Write(S"<b>Login: </b>");
 Response->Write(S"<input type=text id=user /> ");
 Response->Write(S"<input type=submit value=Submit /><br><br>");
 
 Response->WriteFile(FileHandle, StartPos, FileSize);
    
 MyFileStream->Close();
    

[JScript] 
var myFileStream : FileStream
var fileName : String
var fileHandle : IntPtr
var startPos : long = 0
var fileSize : 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()

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: