FileStreamResult クラス (System.Web.Mvc)

FileStreamResultクラスとは、ストリーム（Streamクラスとその派生クラス）の内容を、バイナリデータとしてそのまま送信するActionResultクラスを継承したクラスである。

単純に送信するだけであれば、ストリームとMIMEタイプを指定するだけで使えよく、非常に手軽である。ダウンロード確認ダイアログを表示する場合はHTTPレスポンスヘッダーにContent-Dispositionを設定する（例参照）。

例

ダウンロード確認ダイアログを表示する

ストリーム上のCSVファイルを送信し、ダウンロードの確認ダイアログを表示する例。

    using System.Web.Mvc;
    using System.IO;

    public class HomeController : Controller
    {
        public FileStreamResult DownloadCsv()
        {
            // Content-Dispositionヘッダーに「attachement」と設定することで、
            // ブラウザにダウンロードするかの確認ダイアログを表示させる。
            //
            // Content-Dispositionの値
            //   attachment = ダウンロード
            //   inline     = インライン表示
            // 
            // 「filename=」という部分を書き換えれば、多くのブラウザで保存
            // ダイアログの初期ファイル名となる。IE5.5以前はダメらしい。
            // さすがにもう存在しないだろう。
            this.HttpContext.Response.AddHeader(
                "Content-Disposition", 
                "attachment; filename=file.csv");
 
            // Streamを取得する。
            // CreateCsvメソッドは仮にあるものとする。
            Stream fileStream = CreateCsv();
 
            // fileStreamの内容を結果として送信する。
            return new FileStreamResult(fileStream, "text/csv");
        }
    }

関連項目

• ActionResult
• ASP.NET MVC

外部リンク

• http://msdn.microsoft.com/ja-jp/library/system.web.mvc.filestreamresult.aspx