HttpResponse.WriteFile Metoda

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Přetížení

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

WriteFile(IntPtr, Int64, Int64)

Zapíše zadaný soubor přímo do výstupního datového proudu 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 pro zápis do výstupního datového proudu HTTP.

offset: Int64

Umístění bajtů v souboru, kde začne zápis.

size: Int64

Počet bajtů, které se mají zapisovat 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álový text HTML 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

Pokud se tato metoda používá s velkými soubory, volání metody může vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na konfiguraci hardwaru webového serveru.

Platí pro

WriteFile(String, Int64, Int64)

Zapíše zadaný soubor přímo do výstupního datového proudu 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 pro zápis do výstupního datového proudu HTTP.

offset: Int64

Umístění bajtů v souboru, kde začne zápis.

size: Int64

Počet bajtů, které se mají zapisovat 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 ovládací prvky literálového textu a 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

Pokud se tato metoda používá s velkými soubory, volání metody může vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na konfiguraci hardwaru webového serveru.

Platí pro

WriteFile(String)

Zapíše obsah zadaného souboru přímo do výstupního datového proudu 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

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

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

Poznámky

Pokud se tato metoda používá s velkými soubory, volání metody může vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na konfiguraci hardwaru webového serveru.

Platí pro

WriteFile(String, Boolean)

Zapíše obsah zadaného souboru přímo do výstupního datového proudu 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, zda bude soubor zapsán 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

Pokud se tato metoda používá s velkými soubory, volání metody může vyvolat výjimku. Velikost souboru, který lze použít s touto metodou, závisí na konfiguraci hardwaru webového serveru.

Platí pro

Váš názor

Byla tato stránka užitečná?