HttpResponse.WriteFile Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Grava o arquivo especificado diretamente em um fluxo de saída de resposta HTTP.

Sobrecargas

WriteFile(IntPtr, Int64, Int64)	Grava o arquivo especificado diretamente em um fluxo de saída de resposta HTTP.
WriteFile(String, Int64, Int64)	Grava o arquivo especificado diretamente em um fluxo de saída de resposta HTTP.
WriteFile(String)	Grava o conteúdo do arquivo especificado diretamente em um fluxo de saída de resposta HTTP como um bloco de arquivo.
WriteFile(String, Boolean)	Grava o conteúdo do arquivo especificado diretamente em um fluxo de saída de resposta HTTP como um bloco de memória.

WriteFile(IntPtr, Int64, Int64)

Grava o arquivo especificado diretamente em um fluxo de saída de resposta 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)

Parâmetros

fileHandle

IntPtr

nativeint

O identificador de arquivo do arquivo a ser gravado no fluxo de saída HTTP.

offset

Int64

A posição de byte no arquivo em que a gravação será iniciada.

size

Int64

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

Exceções

ArgumentNullException

fileHandler é null.

HttpException

offset é menor que 0.

- ou -

size é maior que o tamanho do arquivo menos offset.

Exemplos

O exemplo a seguir grava todo o conteúdo de um arquivo de texto chamado Login.txt (que pode conter controles de entrada e texto HTML literais) 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()

Comentários

Quando esse método é usado com arquivos grandes, chamar o método pode gerar uma exceção. O tamanho do arquivo que pode ser usado com esse método depende da configuração de hardware do servidor Web.

WriteFile(String, Int64, Int64)

Grava o arquivo especificado diretamente em um fluxo de saída de resposta 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)

Parâmetros

filename

String

O nome do arquivo a ser gravado no fluxo de saída HTTP.

offset

Int64

A posição de byte no arquivo em que a gravação será iniciada.

size

Int64

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

Exceções

HttpException

offset é menor que 0.

- ou -

size é maior que o tamanho do arquivo menos offset.

ArgumentNullException

O parâmetro filename é null.

Exemplos

O exemplo a seguir grava todo o conteúdo de um arquivo de texto chamado Login.txt (que pode conter controles de entrada HTML e texto literal) 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)
    

Comentários

Quando esse método é usado com arquivos grandes, chamar o método pode gerar uma exceção. O tamanho do arquivo que pode ser usado com esse método depende da configuração de hardware do servidor Web.

WriteFile(String)

Grava o conteúdo do arquivo especificado diretamente em um fluxo de saída de resposta HTTP como um bloco de arquivo.

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 arquivo no qual a saída HTTP será gravada.

Exceções

ArgumentNullException

O parâmetro filename é null.

Exemplos

O exemplo a seguir grava todo o conteúdo de um arquivo de texto chamado Login.txt (que pode conter controles de entrada e texto HTML literais) diretamente no fluxo de saída.

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

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

Comentários

Quando esse método é usado com arquivos grandes, chamar o método pode gerar uma exceção. O tamanho do arquivo que pode ser usado com esse método depende da configuração de hardware do servidor Web.

WriteFile(String, Boolean)

Grava o conteúdo do arquivo especificado diretamente em um fluxo de saída de resposta HTTP como um 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 arquivo para gravar em um bloco de memória.

readIntoMemory

Boolean

Indica se o arquivo será gravado em um bloco de memória.

Exceções

ArgumentNullException

O parâmetro filename é null.

Exemplos

O exemplo a seguir grava um arquivo na memória.

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

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

Comentários

Quando esse método é usado com arquivos grandes, chamar o método pode gerar uma exceção. O tamanho do arquivo que pode ser usado com esse método depende da configuração de hardware do servidor Web.