HttpResponse.WriteFile Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Zapíše zadaný soubor přímo do výstupního streamu odpovědi HTTP.

Přetížení

WriteFile(IntPtr, Int64, Int64)	Zapíše zadaný soubor přímo do výstupního streamu odpovědi HTTP.
WriteFile(String, Int64, Int64)	Zapíše zadaný soubor přímo do výstupního streamu odpovědi HTTP.
WriteFile(String)	Zapíše obsah zadaného souboru přímo do výstupního streamu odpovědi HTTP jako blok souboru.
WriteFile(String, Boolean)	Zapíše obsah zadaného souboru přímo do výstupního streamu odpovědi HTTP jako blok paměti.

WriteFile(IntPtr, Int64, Int64)

Zapíše zadaný soubor přímo do výstupního streamu odpovědi 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)

Parametry

fileHandle

IntPtr

nativeint

Popisovač souboru, který se má zapisovat do výstupního streamu HTTP.

offset

Int64

Pozice bajtu v souboru, kde se začne psát.

size

Int64

Počet bajtů, které se mají zapsat do výstupního datového proudu.

Výjimky

ArgumentNullException

fileHandler je null.

HttpException

offset je menší než 0.

-nebo-

size je větší než velikost souboru minus offset.

Příklady

Následující příklad zapíše veškerý obsah textového souboru s názvem Login.txt (který může obsahovat literál html text a vstupní ovládací prvky) přímo do výstupního datového proudu.

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

Poznámky

Při použití této metody s velkými soubory může volání metody vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na hardwarové konfiguraci webového serveru.

WriteFile(String, Int64, Int64)

Zapíše zadaný soubor přímo do výstupního streamu odpovědi 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)

Parametry

filename

String

Název souboru, který se má zapisovat do výstupního streamu HTTP.

offset

Int64

Pozice bajtu v souboru, kde se začne psát.

size

Int64

Počet bajtů, které se mají zapsat do výstupního datového proudu.

Výjimky

HttpException

offset je menší než 0.

-nebo-

size je větší než velikost souboru minus offset.

ArgumentNullException

Parametr filename je null.

Příklady

Následující příklad zapíše veškerý obsah textového souboru s názvem Login.txt (který může obsahovat text literálu a ovládací prvky vstupu HTML) přímo do výstupního datového proudu.

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)
    

Poznámky

Při použití této metody s velkými soubory může volání metody vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na hardwarové konfiguraci webového serveru.

WriteFile(String)

Zapíše obsah zadaného souboru přímo do výstupního streamu odpovědi HTTP jako blok souboru.

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

public void WriteFile (string filename);

member this.WriteFile : string -> unit

Public Sub WriteFile (filename As String)

Parametry

filename

String

Název souboru, který se má zapisovat do výstupu HTTP.

Výjimky

ArgumentNullException

Parametr filename je null.

Příklady

Následující příklad zapíše veškerý obsah textového souboru s názvem Login.txt (který může obsahovat literál html text a vstupní ovládací prvky) přímo do výstupního datového proudu.

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

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

Poznámky

Při použití této metody s velkými soubory může volání metody vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na hardwarové konfiguraci webového serveru.

WriteFile(String, Boolean)

Zapíše obsah zadaného souboru přímo do výstupního streamu odpovědi HTTP jako blok paměti.

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)

Parametry

filename

String

Název souboru, který se má zapisovat do bloku paměti.

readIntoMemory

Boolean

Určuje, jestli se soubor zapíše do bloku paměti.

Výjimky

ArgumentNullException

Parametr filename je null.

Příklady

Následující příklad zapíše soubor do paměti.

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

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

Poznámky

Při použití této metody s velkými soubory může volání metody vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na hardwarové konfiguraci webového serveru.