HttpResponse.WriteFile Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Schreibt die angegebene Datei direkt in einen Ausgabestream für HTTP-Antworten.

Überlädt

WriteFile(IntPtr, Int64, Int64)	Schreibt die angegebene Datei direkt in einen Ausgabestream für HTTP-Antworten.
WriteFile(String, Int64, Int64)	Schreibt die angegebene Datei direkt in einen Ausgabestream für HTTP-Antworten.
WriteFile(String)	Schreibt den Inhalt der angegebenen Datei als Dateiblock direkt in einen HTTP-Antwort-Ausgabestream.
WriteFile(String, Boolean)	Schreibt den Inhalt der angegebenen Datei als Speicherblock direkt in einen HTTP-Antwort-Ausgabestream.

WriteFile(IntPtr, Int64, Int64)

Schreibt die angegebene Datei direkt in einen Ausgabestream für HTTP-Antworten.

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)

Parameter

fileHandle

IntPtr

nativeint

Das Dateihandle der Datei, die in den HTTP-Ausgabestream geschrieben werden soll.

offset

Int64

Die Byteposition in der Datei, an der der Schreibvorgang beginnt.

size

Int64

Die Anzahl der Bytes, die in den Ausgabestream geschrieben werden sollen.

Ausnahmen

ArgumentNullException

fileHandler ist null.

HttpException

offset ist kleiner als 0.

- oder -

size ist größer als die Dateigröße minus offset.

Beispiele

Im folgenden Beispiel wird der gesamte Inhalt einer Textdatei namens Login.txt (die möglicherweise LITERAL-HTML-Text und Eingabesteuerelemente enthalten kann) direkt in den Ausgabestream geschrieben.

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

Hinweise

Wenn diese Methode mit großen Dateien verwendet wird, löst das Aufrufen der Methode möglicherweise eine Ausnahme aus. Die Größe der Datei, die mit dieser Methode verwendet werden kann, hängt von der Hardwarekonfiguration des Webservers ab.

WriteFile(String, Int64, Int64)

Schreibt die angegebene Datei direkt in einen Ausgabestream für HTTP-Antworten.

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)

Parameter

filename

String

Der Name der Datei, die in den HTTP-Ausgabestream geschrieben werden soll.

offset

Int64

Die Byteposition in der Datei, an der der Schreibvorgang beginnt.

size

Int64

Die Anzahl der Bytes, die in den Ausgabestream geschrieben werden sollen.

Ausnahmen

HttpException

offset ist kleiner als 0.

- oder -

size ist größer als die Dateigröße minus offset.

ArgumentNullException

Der filename-Parameter ist null.

Beispiele

Im folgenden Beispiel wird der gesamte Inhalt einer Textdatei namens Login.txt (die Literaltext und HTML-Eingabesteuerelemente enthalten kann) direkt in den Ausgabestream geschrieben.

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)
    

Hinweise

Wenn diese Methode mit großen Dateien verwendet wird, löst das Aufrufen der Methode möglicherweise eine Ausnahme aus. Die Größe der Datei, die mit dieser Methode verwendet werden kann, hängt von der Hardwarekonfiguration des Webservers ab.

WriteFile(String)

Schreibt den Inhalt der angegebenen Datei als Dateiblock direkt in einen HTTP-Antwort-Ausgabestream.

public:
 void WriteFile(System::String ^ filename);

public void WriteFile (string filename);

member this.WriteFile : string -> unit

Public Sub WriteFile (filename As String)

Parameter

filename

String

Der Name der Datei, die in die HTTP-Ausgabe geschrieben werden soll.

Ausnahmen

ArgumentNullException

Der filename-Parameter ist null.

Beispiele

Im folgenden Beispiel wird der gesamte Inhalt einer Textdatei namens Login.txt (die möglicherweise LITERAL-HTML-Text und Eingabesteuerelemente enthalten kann) direkt in den Ausgabestream geschrieben.

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

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

Hinweise

Wenn diese Methode mit großen Dateien verwendet wird, löst das Aufrufen der Methode möglicherweise eine Ausnahme aus. Die Größe der Datei, die mit dieser Methode verwendet werden kann, hängt von der Hardwarekonfiguration des Webservers ab.

WriteFile(String, Boolean)

Schreibt den Inhalt der angegebenen Datei als Speicherblock direkt in einen HTTP-Antwort-Ausgabestream.

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)

Parameter

filename

String

Der Name der Datei, die in einen Speicherblock geschrieben werden soll.

readIntoMemory

Boolean

Gibt an, ob die Datei in einen Speicherblock geschrieben wird.

Ausnahmen

ArgumentNullException

Der filename-Parameter ist null.

Beispiele

Im folgenden Beispiel wird eine Datei in den Arbeitsspeicher geschrieben.

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

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

Hinweise

Wenn diese Methode mit großen Dateien verwendet wird, löst das Aufrufen der Methode möglicherweise eine Ausnahme aus. Die Größe der Datei, die mit dieser Methode verwendet werden kann, hängt von der Hardwarekonfiguration des Webservers ab.