HttpResponse.WriteFile Método

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Escreve o ficheiro especificado diretamente num fluxo de resposta HTTP de saída.

Sobrecargas

Name Description
WriteFile(IntPtr, Int64, Int64)

Escreve o ficheiro especificado diretamente num fluxo de resposta HTTP de saída.
WriteFile(String, Int64, Int64)

Escreve o ficheiro especificado diretamente num fluxo de resposta HTTP de saída.
WriteFile(String)

Escreve o conteúdo do ficheiro especificado diretamente num fluxo de resposta HTTP como bloco de ficheiro.
WriteFile(String, Boolean)

Escreve o conteúdo do ficheiro especificado diretamente num fluxo de resposta HTTP como bloco de memória.

WriteFile(IntPtr, Int64, Int64)

Escreve o ficheiro especificado diretamente num fluxo de resposta HTTP de saída.

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)

Parâmetros

fileHandle
IntPtr

nativeint

O handle do ficheiro para escrever no fluxo de saída HTTP.

offset
Int64

A posição do byte no ficheiro onde a escrita vai começar.

size
Int64

O número de bytes a escrever no fluxo de saída.

Exceções

ArgumentNullException

fileHandler é null.

HttpException

offset é inferior a 0.

-ou-

size é maior do que o tamanho do ficheiro menos offset.

Exemplos

O exemplo seguinte escreve todo o conteúdo de um ficheiro de texto chamado Login.txt (que pode conter texto HTML literal e controlos de entrada) diretamente no fluxo de saída.

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

Observações

Quando este método é usado com ficheiros grandes, chamar o método pode lançar uma exceção. O tamanho do ficheiro que pode ser usado com este método depende da configuração de hardware do servidor Web.

Aplica-se a

WriteFile(String, Int64, Int64)

Escreve o ficheiro especificado diretamente num fluxo de resposta HTTP de saída.

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)

Parâmetros

filename
String

O nome do ficheiro a escrever no fluxo de saída HTTP.

offset
Int64

A posição do byte no ficheiro onde a escrita vai começar.

size
Int64

O número de bytes a escrever no fluxo de saída.

Exceções

HttpException

offset é inferior a 0.

-ou-

size é maior do que o tamanho do ficheiro menos offset.

ArgumentNullException

O filename parâmetro é null.

Exemplos

O exemplo seguinte escreve todo o conteúdo de um ficheiro de texto nomeado Login.txt (que pode conter texto literal e controlos de entrada HTML) diretamente no fluxo de saída.

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)

Observações

Quando este método é usado com ficheiros grandes, chamar o método pode lançar uma exceção. O tamanho do ficheiro que pode ser usado com este método depende da configuração de hardware do servidor Web.

Aplica-se a

WriteFile(String)

Escreve o conteúdo do ficheiro especificado diretamente num fluxo de resposta HTTP como bloco de ficheiro.

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

Parâmetros

filename
String

O nome do ficheiro a escrever na saída HTTP.

Exceções

ArgumentNullException

O filename parâmetro é null.

Exemplos

O exemplo seguinte escreve todo o conteúdo de um ficheiro de texto chamado Login.txt (que pode conter texto HTML literal e controlos de entrada) diretamente no fluxo de saída.

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


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

Observações

Quando este método é usado com ficheiros grandes, chamar o método pode lançar uma exceção. O tamanho do ficheiro que pode ser usado com este método depende da configuração de hardware do servidor Web.

Aplica-se a

WriteFile(String, Boolean)

Escreve o conteúdo do ficheiro especificado diretamente num fluxo de resposta HTTP como bloco de memória.

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)

Parâmetros

filename
String

O nome do ficheiro a escrever num bloco de memória.

readIntoMemory
Boolean

Indica se o ficheiro será gravado num bloco de memória.

Exceções

ArgumentNullException

O filename parâmetro é null.

Exemplos

O exemplo seguinte escreve um ficheiro na memória.

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


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

Observações

Quando este método é usado com ficheiros grandes, chamar o método pode lançar uma exceção. O tamanho do ficheiro que pode ser usado com este método depende da configuração de hardware do servidor Web.

Aplica-se a