HttpResponse.WriteFile HttpResponse.WriteFile HttpResponse.WriteFile HttpResponse.WriteFile Method

Definición

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.Writes the specified file directly to an HTTP response output stream.

Sobrecargas

WriteFile(IntPtr, Int64, Int64) WriteFile(IntPtr, Int64, Int64) WriteFile(IntPtr, Int64, Int64) WriteFile(IntPtr, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.Writes the specified file directly to an HTTP response output stream.

WriteFile(String, Int64, Int64) WriteFile(String, Int64, Int64) WriteFile(String, Int64, Int64) WriteFile(String, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.Writes the specified file directly to an HTTP response output stream.

WriteFile(String) WriteFile(String) WriteFile(String) WriteFile(String)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de archivos.Writes the contents of the specified file directly to an HTTP response output stream as a file block.

WriteFile(String, Boolean) WriteFile(String, Boolean) WriteFile(String, Boolean) WriteFile(String, Boolean)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de memoria.Writes the contents of the specified file directly to an HTTP response output stream as a memory block.

WriteFile(IntPtr, Int64, Int64) WriteFile(IntPtr, Int64, Int64) WriteFile(IntPtr, Int64, Int64) WriteFile(IntPtr, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.Writes the specified file directly to an HTTP response output stream.

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 IntPtr IntPtr IntPtr

Identificador del archivo que se escribirá en el flujo de salida HTTP.The file handle of the file to write to the HTTP output stream.

offset
Int64 Int64 Int64 Int64

Posición en el archivo donde se iniciará la escritura.The byte position in the file where writing will start.

size
Int64 Int64 Int64 Int64

Número de bytes que se va a escribir en el flujo de salida.The number of bytes to write to the output stream.

Excepciones

offset es menor que 0.offset is less than 0.

o bien-or- size es mayor que el tamaño de archivo menos offset.size is greater than the file size minus offset.

Ejemplos

En el ejemplo siguiente se escribe todo el contenido de un archivo Login.txt de texto denominado (que puede contener texto HTML literal y controles de entrada) directamente en el flujo de salida.The following example writes all the contents of a text file named Login.txt (which might contain literal HTML text and input controls) directly to the output stream.

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 utiliza con archivos grandes, llamar al método podría producir una excepción.When this method is used with large files, calling the method might throw an exception. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor Web.The size of the file that can be used with this method depends on the hardware configuration of the Web server. Para obtener más información, consulte el artículo 812406, "PRB: Response. WriteFile no puede descargar un archivo grande en el sitio web de Microsoft Knowledge Base .For more information, see article 812406, "PRB: Response.WriteFile Cannot Download a Large File" on the Microsoft Knowledge Base Web site.

WriteFile(String, Int64, Int64) WriteFile(String, Int64, Int64) WriteFile(String, Int64, Int64) WriteFile(String, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.Writes the specified file directly to an HTTP response output stream.

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 String String String

Nombre del archivo que se escribirá en el flujo de salida HTTP.The name of the file to write to the HTTP output stream.

offset
Int64 Int64 Int64 Int64

Posición en el archivo donde se iniciará la escritura.The byte position in the file where writing will start.

size
Int64 Int64 Int64 Int64

Número de bytes que se va a escribir en el flujo de salida.The number of bytes to write to the output stream.

Excepciones

offset es menor que 0.offset is less than 0.

O bien-or- size es mayor que el tamaño de archivo menos offset.size is greater than the file size minus offset.

El parámetro filename es null.The filename parameter is null.

Ejemplos

En el ejemplo siguiente se escribe todo el contenido de un archivo Login.txt de texto denominado (que puede contener texto literal y controles de entrada HTML) directamente en el flujo de salida.The following example writes all the contents of a text file named Login.txt (which might contain literal text and HTML input controls) directly to the output stream.

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 utiliza con archivos grandes, llamar al método podría producir una excepción.When this method is used with large files, calling the method might throw an exception. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor Web.The size of the file that can be used with this method depends on the hardware configuration of the Web server. Para obtener más información, consulte el artículo 812406, "PRB: Response. WriteFile no puede descargar un archivo grande en el sitio web de Microsoft Knowledge Base .For more information, see article 812406, "PRB: Response.WriteFile Cannot Download a Large File" on the Microsoft Knowledge Base Web site.

WriteFile(String) WriteFile(String) WriteFile(String) WriteFile(String)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de archivos.Writes the contents of the specified file directly to an HTTP response output stream as a file block.

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 String String String

Nombre del archivo que se escribirá en la salida HTTP.The name of the file to write to the HTTP output.

Excepciones

El parámetro filename es null.The filename parameter is null.

Ejemplos

En el ejemplo siguiente se escribe todo el contenido de un archivo Login.txt de texto denominado (que puede contener texto HTML literal y controles de entrada) directamente en el flujo de salida.The following example writes all the contents of a text file named Login.txt (which might contain literal HTML text and input controls) directly to the output stream.

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

Comentarios

Cuando este método se utiliza con archivos grandes, llamar al método podría producir una excepción.When this method is used with large files, calling the method might throw an exception. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor Web.The size of the file that can be used with this method depends on the hardware configuration of the Web server. Para obtener más información, consulte el artículo 812406, "PRB: Response. WriteFile no puede descargar un archivo grande en el sitio web de Microsoft Knowledge Base .For more information, see article 812406, "PRB: Response.WriteFile Cannot Download a Large File" on the Microsoft Knowledge Base Web site.

WriteFile(String, Boolean) WriteFile(String, Boolean) WriteFile(String, Boolean) WriteFile(String, Boolean)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de memoria.Writes the contents of the specified file directly to an HTTP response output stream as a memory block.

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 String String String

Nombre del archivo que se escribirá en un bloque de memoria.The name of the file to write into a memory block.

readIntoMemory
Boolean Boolean Boolean Boolean

Indica si el archivo se va a escribir en un bloque de memoria.Indicates whether the file will be written into a memory block.

Excepciones

El parámetro filename es null.The filename parameter is null.

Ejemplos

En el ejemplo siguiente se escribe un archivo en la memoria.The following example writes a file to memory.

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

Comentarios

Cuando este método se utiliza con archivos grandes, llamar al método podría producir una excepción.When this method is used with large files, calling the method might throw an exception. El tamaño del archivo que se puede usar con este método depende de la configuración de hardware del servidor Web.The size of the file that can be used with this method depends on the hardware configuration of the Web server. Para obtener más información, consulte el artículo 812406, "PRB: Response. WriteFile no puede descargar un archivo grande en el sitio web de Microsoft Knowledge Base .For more information, see article 812406, "PRB: Response.WriteFile Cannot Download a Large File" on the Microsoft Knowledge Base Web site.

Se aplica a