Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

HttpResponse::TransmitFile Method (String^, Int64, Int64)

 

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

Namespace:   System.Web
Assembly:  System.Web (in System.Web.dll)

public:
void TransmitFile(
	String^ filename,
	long long offset,
	long long length
)

Parameters

filename
Type: System::String^

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

offset
Type: System::Int64

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

length
Type: System::Int64

The number of bytes to be transmitted.

Exception Condition
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.

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

.NET Framework
Available since 2.0
Return to top
Show:
© 2017 Microsoft