HttpResponse.WriteFile Метод

Определение

Пространство имен:
System.Web
Сборка:
System.Web.dll

Записывает указанный файл непосредственно в поток выходных данных ответа HTTP.

Перегрузки

Имя Описание
WriteFile(IntPtr, Int64, Int64)

Записывает указанный файл непосредственно в поток выходных данных ответа HTTP.
WriteFile(String, Int64, Int64)

Записывает указанный файл непосредственно в поток выходных данных ответа HTTP.
WriteFile(String)

Записывает содержимое указанного файла непосредственно в выходной поток ответа HTTP в виде блока файлов.
WriteFile(String, Boolean)

Записывает содержимое указанного файла непосредственно в поток выходных данных ответа HTTP в виде блока памяти.

WriteFile(IntPtr, Int64, Int64)

Записывает указанный файл непосредственно в поток выходных данных ответа HTTP.

public:
 void WriteFile(IntPtr fileHandle, long offset, long size);
public void WriteFile(IntPtr fileHandle, long offset, long size);
member this.WriteFile : nativeint * int64 * int64 -> unit
Public Sub WriteFile (fileHandle As IntPtr, offset As Long, size As Long)

Параметры

fileHandle
IntPtr

nativeint

Дескриптор файла для записи в поток выходных данных HTTP.

offset
Int64

Позиция байтов в файле, в котором начнется запись.

size
Int64

Количество байтов для записи в выходной поток.

Исключения

ArgumentNullException

fileHandler равно null.

HttpException

offset меньше 0.

–или–

size больше размера файла минус offset.

Примеры

В следующем примере записывается все содержимое текстового файла с именем Login.txt (который может содержать литеральный html-текст и элементы управления входными данными) непосредственно в выходной поток.

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();


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

Комментарии

Если этот метод используется с большими файлами, вызов метода может вызвать исключение. Размер файла, который можно использовать с этим методом, зависит от конфигурации оборудования веб-сервера.

Применяется к

WriteFile(String, Int64, Int64)

Записывает указанный файл непосредственно в поток выходных данных ответа HTTP.

public:
 void WriteFile(System::String ^ filename, long offset, long size);
public void WriteFile(string filename, long offset, long size);
member this.WriteFile : string * int64 * int64 -> unit
Public Sub WriteFile (filename As String, offset As Long, size As Long)

Параметры

filename
String

Имя файла для записи в поток выходных данных HTTP.

offset
Int64

Позиция байтов в файле, в котором начнется запись.

size
Int64

Количество байтов для записи в выходной поток.

Исключения

HttpException

offset меньше 0.

–или–

size больше размера файла минус offset.

ArgumentNullException

Параметр filename имеет значение null.

Примеры

В следующем примере записывается все содержимое текстового файла с именем Login.txt (который может содержать литеральный текст и элементы управления входными данными HTML) непосредственно в выходной поток.

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);


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)

Комментарии

Если этот метод используется с большими файлами, вызов метода может вызвать исключение. Размер файла, который можно использовать с этим методом, зависит от конфигурации оборудования веб-сервера.

Применяется к

WriteFile(String)

Записывает содержимое указанного файла непосредственно в выходной поток ответа HTTP в виде блока файлов.

public:
 void WriteFile(System::String ^ filename);
public void WriteFile(string filename);
member this.WriteFile : string -> unit
Public Sub WriteFile (filename As String)

Параметры

filename
String

Имя файла для записи в выходные данные HTTP.

Исключения

ArgumentNullException

Параметр filename имеет значение null.

Примеры

В следующем примере записывается все содержимое текстового файла с именем Login.txt (который может содержать литеральный html-текст и элементы управления входными данными) непосредственно в выходной поток.

Response.Write("Please Login: <br>");
 Response.WriteFile("login.txt");


Response.Write("Please Login: <br>")
 Response.WriteFile("login.txt")

Комментарии

Если этот метод используется с большими файлами, вызов метода может вызвать исключение. Размер файла, который можно использовать с этим методом, зависит от конфигурации оборудования веб-сервера.

Применяется к

WriteFile(String, Boolean)

Записывает содержимое указанного файла непосредственно в поток выходных данных ответа HTTP в виде блока памяти.

public:
 void WriteFile(System::String ^ filename, bool readIntoMemory);
public void WriteFile(string filename, bool readIntoMemory);
member this.WriteFile : string * bool -> unit
Public Sub WriteFile (filename As String, readIntoMemory As Boolean)

Параметры

filename
String

Имя файла для записи в блок памяти.

readIntoMemory
Boolean

Указывает, будет ли файл записан в блок памяти.

Исключения

ArgumentNullException

Параметр filename имеет значение null.

Примеры

В следующем примере файл записывается в память.

Response.WriteFile("login.txt", true);


Response.WriteFile("login.txt", True)

Комментарии

Если этот метод используется с большими файлами, вызов метода может вызвать исключение. Размер файла, который можно использовать с этим методом, зависит от конфигурации оборудования веб-сервера.

Применяется к