HttpResponse.WriteFile Methode

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom.

Überlädt

Name Beschreibung
WriteFile(IntPtr, Int64, Int64)

Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom.
WriteFile(String, Int64, Int64)

Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom.
WriteFile(String)

Schreibt den Inhalt der angegebenen Datei direkt in einen HTTP-Antwortausgabedatenstrom als Dateiblock.
WriteFile(String, Boolean)

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

WriteFile(IntPtr, Int64, Int64)

Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom.

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-Ausgabedatenstrom geschrieben werden soll.

offset
Int64

Die Byteposition in der Datei, an der das Schreiben beginnt.

size
Int64

Die Anzahl der Bytes, die in den Ausgabedatenstrom 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 werden alle Inhalte einer Textdatei mit dem Namen Login.txt (die Literal-HTML-Text und Eingabesteuerelemente enthalten kann) direkt in den Ausgabedatenstrom 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.

Gilt für:

WriteFile(String, Int64, Int64)

Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom.

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-Ausgabedatenstrom geschrieben werden soll.

offset
Int64

Die Byteposition in der Datei, an der das Schreiben beginnt.

size
Int64

Die Anzahl der Bytes, die in den Ausgabedatenstrom 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 werden alle Inhalte einer Textdatei mit dem Namen Login.txt (die Literaltext und HTML-Eingabesteuerelemente enthalten kann) direkt in den Ausgabedatenstrom 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.

Gilt für:

WriteFile(String)

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

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 werden alle Inhalte einer Textdatei mit dem Namen Login.txt (die Literal-HTML-Text und Eingabesteuerelemente enthalten kann) direkt in den Ausgabedatenstrom 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.

Gilt für:

WriteFile(String, Boolean)

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

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.

Gilt für: