HttpResponse.WriteFile メソッド

定義

名前空間:

System.Web

アセンブリ:

System.Web.dll

指定したファイルを HTTP 応答出力ストリームに直接書き込みます。

オーバーロード

WriteFile(IntPtr, Int64, Int64)	指定したファイルを HTTP 応答出力ストリームに直接書き込みます。
WriteFile(String, Int64, Int64)	指定したファイルを HTTP 応答出力ストリームに直接書き込みます。
WriteFile(String)	指定されたファイルの内容を、ファイル ブロックとして HTTP 応答出力ストリームに直接書き込みます。
WriteFile(String, Boolean)	指定されたファイルの内容を、メモリ ブロックとして HTTP 応答出力ストリームに直接書き込みます。

WriteFile(IntPtr, Int64, Int64)

指定したファイルを 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)

パラメーター

fileHandle

IntPtr

nativeint

HTTP 出力ストリームに書き込むファイルのファイル ハンドル。

offset

Int64

書き込みを開始するファイル内のバイト位置。

size

Int64

出力ストリームに書き込むバイト数。

例外

ArgumentNullException

fileHandler が nullです。

HttpException

offset が 0 未満です。

または

size は、ファイル サイズから offset を引いた値を超えています。

例

次の例では、 という名前 Login.txt のテキスト ファイルのすべての内容 (リテラル HTML テキストと入力コントロールを含む可能性があります) を出力ストリームに直接書き込みます。

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

注釈

このメソッドを大きなファイルと共に使用すると、 メソッドを呼び出すと例外がスローされる可能性があります。 この方法で使用できるファイルのサイズは、Web サーバーのハードウェア構成によって異なります。

WriteFile(String, Int64, Int64)

指定したファイルを 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)

パラメーター

filename

String

HTTP 出力ストリームに書き込むファイルの名前。

offset

Int64

書き込みを開始するファイル内のバイト位置。

size

Int64

出力ストリームに書き込むバイト数。

例外

HttpException

offset が 0 未満です。

または

size は、ファイル サイズから offset を引いた値を超えています。

ArgumentNullException

filename パラメーターが null です。

例

次の例では、 という名前 Login.txt のテキスト ファイルのすべての内容 (リテラル テキストと HTML 入力コントロールを含む可能性があります) を出力ストリームに直接書き込みます。

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)
    

注釈

このメソッドを大きなファイルと共に使用すると、 メソッドを呼び出すと例外がスローされる可能性があります。 この方法で使用できるファイルのサイズは、Web サーバーのハードウェア構成によって異なります。

WriteFile(String)

指定されたファイルの内容を、ファイル ブロックとして HTTP 応答出力ストリームに直接書き込みます。

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

public void WriteFile (string filename);

member this.WriteFile : string -> unit

Public Sub WriteFile (filename As String)

パラメーター

filename

String

HTTP 出力に書き込むファイルの名前。

例外

ArgumentNullException

filename パラメーターが null です。

例

次の例では、 という名前 Login.txt のテキスト ファイルのすべての内容 (リテラル HTML テキストと入力コントロールを含む可能性があります) を出力ストリームに直接書き込みます。

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

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

注釈

このメソッドを大きなファイルと共に使用すると、 メソッドを呼び出すと例外がスローされる可能性があります。 この方法で使用できるファイルのサイズは、Web サーバーのハードウェア構成によって異なります。

WriteFile(String, Boolean)

指定されたファイルの内容を、メモリ ブロックとして HTTP 応答出力ストリームに直接書き込みます。

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)

パラメーター

filename

String

メモリ ブロックに書き込むファイルの名前。

readIntoMemory

Boolean

ファイルがメモリ ブロックに書き込まれるかどうかを示します。

例外

ArgumentNullException

filename パラメーターが null です。

例

次の例では、ファイルをメモリに書き込みます。

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

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

注釈

このメソッドを大きなファイルと共に使用すると、 メソッドを呼び出すと例外がスローされる可能性があります。 この方法で使用できるファイルのサイズは、Web サーバーのハードウェア構成によって異なります。