HttpResponse.WriteFile Метод

Ссылка

Определение

Пространство имен:: System.Web

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

WriteFile(IntPtr, Int64, Int64)

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

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

Дескриптор файла, который записывается в поток вывода НТТР.

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)

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

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

Имя файла, который записывается в поток вывода НТТР.

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

Имя файла, который записывается в выходные данные НТТР.

Исключения

ArgumentNullException

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

Примеры

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)

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

Поделиться через

HttpResponse.WriteFile Метод

Определение

Перегрузки

WriteFile(IntPtr, Int64, Int64)

Параметры

Исключения

Примеры

Комментарии

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

WriteFile(String, Int64, Int64)

Параметры

Исключения

Примеры

Комментарии

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

WriteFile(String)

Параметры

Исключения

Примеры

Комментарии

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

WriteFile(String, Boolean)

Параметры

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы