HttpResponse.WriteFile Metódus

Definíció

Névtér:

System.Web

Szerelvény:

System.Web.dll

A megadott fájlt közvetlenül egy HTTP-válasz kimeneti streambe írja.

Túlterhelések

Name	Description
WriteFile(IntPtr, Int64, Int64)	A megadott fájlt közvetlenül egy HTTP-válasz kimeneti streambe írja.
WriteFile(String, Int64, Int64)	A megadott fájlt közvetlenül egy HTTP-válasz kimeneti streambe írja.
WriteFile(String)	A megadott fájl tartalmát közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja fájlblokkként.
WriteFile(String, Boolean)	A megadott fájl tartalmát közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja memóriablokkként.

WriteFile(IntPtr, Int64, Int64)

A megadott fájlt közvetlenül egy HTTP-válasz kimeneti streambe írja.

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)

Paraméterek

fileHandle

IntPtr

nativeint

A HTTP-kimeneti adatfolyamba írandó fájl leírója.

offset

Int64

A bájt helye abban a fájlban, ahol az írás elindul.

size

Int64

A kimeneti adatfolyamba írandó bájtok száma.

Kivételek

ArgumentNullException

fileHandler az null.

HttpException

offset kisebb, mint 0.

-vagy-

size nagyobb, mint a fájlméret mínusz offset.

Példák

Az alábbi példa közvetlenül a kimeneti adatfolyamba írja egy elnevezett Login.txt szövegfájl összes tartalmát (amely literális HTML-szöveget és beviteli vezérlőket tartalmazhat).

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

Megjegyzések

Ha ezt a metódust nagy fájlokkal használja, a metódus meghívása kivételt eredményezhet. Az ezzel a módszerrel használható fájl mérete a webkiszolgáló hardverkonfigurációjától függ.

WriteFile(String, Int64, Int64)

A megadott fájlt közvetlenül egy HTTP-válasz kimeneti streambe írja.

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)

Paraméterek

filename

String

A HTTP kimeneti adatfolyamba írni kívánt fájl neve.

offset

Int64

A bájt helye abban a fájlban, ahol az írás elindul.

size

Int64

A kimeneti adatfolyamba írandó bájtok száma.

Kivételek

HttpException

offset kisebb, mint 0.

-vagy-

size nagyobb, mint a fájlméret mínusz offset.

ArgumentNullException

A filename paraméter a következő null: .

Példák

Az alábbi példa közvetlenül a kimeneti adatfolyamba írja egy elnevezett Login.txt szövegfájl összes tartalmát (amely literális szöveg- és HTML-beviteli vezérlőket tartalmazhat).

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)
    

Megjegyzések

Ha ezt a metódust nagy fájlokkal használja, a metódus meghívása kivételt eredményezhet. Az ezzel a módszerrel használható fájl mérete a webkiszolgáló hardverkonfigurációjától függ.

WriteFile(String)

A megadott fájl tartalmát közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja fájlblokkként.

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

public void WriteFile(string filename);

member this.WriteFile : string -> unit

Public Sub WriteFile (filename As String)

Paraméterek

filename

String

A HTTP-kimenetbe írni kívánt fájl neve.

Kivételek

ArgumentNullException

A filename paraméter a következő null: .

Példák

Az alábbi példa közvetlenül a kimeneti adatfolyamba írja egy elnevezett Login.txt szövegfájl összes tartalmát (amely literális HTML-szöveget és beviteli vezérlőket tartalmazhat).

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

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

Megjegyzések

Ha ezt a metódust nagy fájlokkal használja, a metódus meghívása kivételt eredményezhet. Az ezzel a módszerrel használható fájl mérete a webkiszolgáló hardverkonfigurációjától függ.

WriteFile(String, Boolean)

A megadott fájl tartalmát közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja memóriablokkként.

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)

Paraméterek

filename

String

A memóriablokkba írni kívánt fájl neve.

readIntoMemory

Boolean

Azt jelzi, hogy a fájl memóriablokkba lesz-e írva.

Kivételek

ArgumentNullException

A filename paraméter a következő null: .

Példák

Az alábbi példa egy fájlt ír a memóriába.

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

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

Megjegyzések

Ha ezt a metódust nagy fájlokkal használja, a metódus meghívása kivételt eredményezhet. Az ezzel a módszerrel használható fájl mérete a webkiszolgáló hardverkonfigurációjától függ.