HttpResponse.WriteFile Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web
Zestaw:
System.Web.dll

Zapisuje określony plik bezpośrednio do strumienia wyjściowego odpowiedzi HTTP.

Przeciążenia

WriteFile(IntPtr, Int64, Int64)

Zapisuje określony plik bezpośrednio do strumienia wyjściowego odpowiedzi HTTP.
WriteFile(String, Int64, Int64)

Zapisuje określony plik bezpośrednio do strumienia wyjściowego odpowiedzi HTTP.
WriteFile(String)

Zapisuje zawartość określonego pliku bezpośrednio do strumienia wyjściowego odpowiedzi HTTP jako bloku plików.
WriteFile(String, Boolean)

Zapisuje zawartość określonego pliku bezpośrednio do strumienia wyjściowego odpowiedzi HTTP jako bloku pamięci.

WriteFile(IntPtr, Int64, Int64)

Zapisuje określony plik bezpośrednio do strumienia wyjściowego odpowiedzi 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

Dojście do pliku do zapisu w strumieniu wyjściowym HTTP.

offset
Int64

Pozycja bajtów w pliku, w którym rozpocznie się zapisywanie.

size
Int64

Liczba bajtów do zapisu w strumieniu wyjściowym.

Wyjątki

ArgumentNullException

fileHandler to null.

HttpException

offset wartość jest mniejsza niż 0.

-lub-

size jest większy niż rozmiar pliku minus offset.

Przykłady

Poniższy przykład zapisuje całą zawartość pliku tekstowego o nazwie Login.txt (która może zawierać literał tekst HTML i kontrolki wprowadzania) bezpośrednio do strumienia wyjściowego.

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

Uwagi

Jeśli ta metoda jest używana z dużymi plikami, wywołanie metody może zgłosić wyjątek. Rozmiar pliku, który może być używany z tą metodą, zależy od konfiguracji sprzętowej serwera sieci Web.

Dotyczy

WriteFile(String, Int64, Int64)

Zapisuje określony plik bezpośrednio do strumienia wyjściowego odpowiedzi 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

Nazwa pliku do zapisu w strumieniu wyjściowym HTTP.

offset
Int64

Pozycja bajtów w pliku, w którym rozpocznie się zapisywanie.

size
Int64

Liczba bajtów do zapisu w strumieniu wyjściowym.

Wyjątki

HttpException

offset wartość jest mniejsza niż 0.

-lub-

size jest większy niż rozmiar pliku minus offset.

ArgumentNullException

Parametr filename ma wartość null.

Przykłady

Poniższy przykład zapisuje całą zawartość pliku tekstowego o nazwie Login.txt (która może zawierać kontrolki tekstowe literału i wprowadzania HTML) bezpośrednio do strumienia wyjściowego.

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)

Uwagi

Jeśli ta metoda jest używana z dużymi plikami, wywołanie metody może zgłosić wyjątek. Rozmiar pliku, który może być używany z tą metodą, zależy od konfiguracji sprzętowej serwera sieci Web.

Dotyczy

WriteFile(String)

Zapisuje zawartość określonego pliku bezpośrednio do strumienia wyjściowego odpowiedzi HTTP jako bloku plików.

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

Nazwa pliku do zapisu w danych wyjściowych HTTP.

Wyjątki

ArgumentNullException

Parametr filename ma wartość null.

Przykłady

Poniższy przykład zapisuje całą zawartość pliku tekstowego o nazwie Login.txt (która może zawierać literał tekst HTML i kontrolki wprowadzania) bezpośrednio do strumienia wyjściowego.

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


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

Uwagi

Jeśli ta metoda jest używana z dużymi plikami, wywołanie metody może zgłosić wyjątek. Rozmiar pliku, który może być używany z tą metodą, zależy od konfiguracji sprzętowej serwera sieci Web.

Dotyczy

WriteFile(String, Boolean)

Zapisuje zawartość określonego pliku bezpośrednio do strumienia wyjściowego odpowiedzi HTTP jako bloku pamięci.

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

Nazwa pliku do zapisania w bloku pamięci.

readIntoMemory
Boolean

Wskazuje, czy plik zostanie zapisany w bloku pamięci.

Wyjątki

ArgumentNullException

Parametr filename ma wartość null.

Przykłady

Poniższy przykład zapisuje plik w pamięci.

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


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

Uwagi

Jeśli ta metoda jest używana z dużymi plikami, wywołanie metody może zgłosić wyjątek. Rozmiar pliku, który może być używany z tą metodą, zależy od konfiguracji sprzętowej serwera sieci Web.

Dotyczy