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

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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: