HttpResponse.WriteFile Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.

Sobrecargas

WriteFile(IntPtr, Int64, Int64)	Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.
WriteFile(String, Int64, Int64)	Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.
WriteFile(String)	Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de archivos.
WriteFile(String, Boolean)	Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de memoria.

WriteFile(IntPtr, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta 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

Identificador del archivo que se escribirá en el flujo de salida HTTP.

offset

Int64

Posición del byte en el archivo donde se iniciará la escritura.

size

Int64

Número de bytes que se va a escribir en el flujo de salida.

Excepciones

ArgumentNullException

fileHandler es null.

HttpException

offset es menor que 0.

O bien

size es mayor que el tamaño de archivo menos offset.

Ejemplos

En el ejemplo siguiente se escribe todo el contenido de un archivo de texto denominado Login.txt (que puede contener controles de entrada y texto HTML literales) directamente en el flujo de salida.

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

Comentarios

Cuando este método se usa con archivos grandes, llamar al método podría producir una excepción. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor web.

WriteFile(String, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta 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

Nombre del archivo que se escribirá en el flujo de salida HTTP.

offset

Int64

Posición en el archivo donde se iniciará la escritura.

size

Int64

Número de bytes que se va a escribir en el flujo de salida.

Excepciones

HttpException

offset es menor que 0.

O bien

El valor size es mayor que el tamaño de archivo menos offset.

ArgumentNullException

El parámetro filename es null.

Ejemplos

En el ejemplo siguiente se escribe todo el contenido de un archivo de texto denominado Login.txt (que podría contener controles de entrada HTML y texto literal) directamente en el flujo de salida.

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)
    

Comentarios

Cuando este método se usa con archivos grandes, llamar al método podría producir una excepción. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor web.

WriteFile(String)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de archivos.

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

Nombre del archivo que se escribirá en la salida HTTP.

Excepciones

ArgumentNullException

El parámetro filename es null.

Ejemplos

En el ejemplo siguiente se escribe todo el contenido de un archivo de texto denominado Login.txt (que puede contener controles de entrada y texto HTML literales) directamente en el flujo de salida.

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

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

Comentarios

Cuando este método se usa con archivos grandes, llamar al método podría producir una excepción. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor web.

WriteFile(String, Boolean)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de memoria.

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

Nombre del archivo que se escribirá en un bloque de memoria.

readIntoMemory

Boolean

Indica si el archivo se va a escribir en un bloque de memoria.

Excepciones

ArgumentNullException

El parámetro filename es null.

Ejemplos

En el ejemplo siguiente se escribe un archivo en la memoria.

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

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

Comentarios

Cuando este método se usa con archivos grandes, llamar al método podría producir una excepción. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor web.