HttpResponse.TransmitFile Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Writes the specified file directly to an HTTP response output stream without buffering it in memory.

Overloads

TransmitFile(String, Int64, Int64)	Writes the specified part of a file directly to an HTTP response output stream without buffering it in memory.
TransmitFile(String)	Writes the specified file directly to an HTTP response output stream, without buffering it in memory.

TransmitFile(String, Int64, Int64)

Writes the specified part of a file directly to an HTTP response output stream without buffering it in memory.

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)

Parameters

filename

String

The name of the file to write to the HTTP output.

offset

Int64

The position in the file to begin to write to the HTTP output.

length

Int64

The number of bytes to be transmitted.

Exceptions

ArgumentNullException

The offset parameter is less than zero.

-or-

The length parameter is less than -1.

-or-

The length parameter specifies a number of bytes that is greater than the number of bytes the file contains minus the offset.

PlatformNotSupportedException

The out-of-process worker request is not supported.

-or-

The response is not using an HttpWriter object.

ArgumentException

The offset parameter is less than zero or greater than the file size.

-or-

The length parameter is less than -1 or greater than the value of the offset parameter plus the file size.

Remarks

If you specify 0 as the offset parameter and -1 as the length parameter, the whole file is sent.

TransmitFile(String)

Writes the specified file directly to an HTTP response output stream, without buffering it in memory.

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

public void TransmitFile (string filename);

member this.TransmitFile : string -> unit

Public Sub TransmitFile (filename As String)

Parameters

filename

String

The name of the file to write to the HTTP output.

Exceptions

ArgumentNullException

The filename parameter is null