DoboWiki

• バックアップ一覧
• ソース を表示
• ASP.NET Tips/ファイルをダウンロードできるようにする は削除されています。
  • 1 (2007-11-08 (木) 03:42:25)

現在執筆中です。

ファイルをダウンロードできるようにする †

ここではサーバーにあるファイルをダイアログを表示して、Webブラウザでダウンロードできるようにする方法を紹介します。

レスポンスヘッダに"Content-Disposition"フィールドを追加し、HttpResponse.WriteFileメソッドで書き込みます。"Content-Disposition"については、RFC1806をご覧ください。

次のコードを実行すると、Internet Explorerでは、「ファイルのダウンロード」ダイアログが表示され、デフォルトでファイル名が「test.txt」で保存されるようにしています。このコードは、ページクラスに記述されているものとします。

#code(vbnet){{
}}

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19

//ダウンロードするファイルのパス
string downloadPath = this.Server.MapPath("test.txt");
//保存時に提案するデフォルトのファイル名
string downloadName = "test.txt";
 
this.Response.Clear();
//MINE型を指定する
this.Response.ContentType = "application/octet-stream";
//Content-Dispositionヘッダを追加する
this.Response.AddHeader("Content-Disposition",
    "attachment; filename=" + downloadName);
 
//ファイルを書き込む
this.Response.WriteFile(downloadPath);
//.NET 1.1 SP1以降では次のようにするとよい
//this.Response.TransmitFile(downloadPath);
 
//送信して終了
this.Response.End();

一般的には、"Content-Disposition"があり、"ContentType"が"application/octet-stream"となっている場合に「名前をつけて保存」ダイアログが表示されることになっています。しかし実際には、これでは正常に機能しないケースが多いようです。特にIE5.5以前では、問題が多いようです。よって"ContentType"を"application/download"や"application/octet-stream-dummy"などの意味のないものに変えた方が確実かもしれません。

また、上記の例では"ContentType"を"application/octet-stream"としていますが、適当なMINE型が分かっているのであれば、それを指定してもかまいません。例えば、テキストファイルでは、"text/plain"です。

保存ファイル名について †

Content-Dispositionで指定されたファイル名が必ずつけられて保存される保障はありません。そもそもファイル名を強制して保存することはセキュリティ面で問題です。

Content-Dispositionで指定するファイル名にはASCII文字しか使えません。それ以外の文字についてはRFC2231で定義されていますが、この方法では、少なくともIEでは、うまくいきません。「[PRB] AddHeader, AppendHeader で日本語ファイル名が文字化けする」によると、HttpUtility.UrlEncodeメソッドを使うことによりある程度回避できるということですが、絶対的な解決法でないため、ファイル名に日本語を指定するのはやめるべきです。

参考 †

• 添付ファイルにおける日本語のファイル名に関して
• [Studying HTTP] HTTP Header Fields

上記以外のContent-Dispositionに関するIEのバグ †

上記の問題以外に、IEのバージョンによっては、Content-Dispositionが150バイト以上だとエラーが出るという問題もあります。

• エラー メッセージ : "Internet Explorer では、サイト名 - ファイル名 をダウンロードできません。"

また、IE5.5以前では、Content-Dispositionの「attachment」の代わりに「inline」を使わなければ正常に機能しないという話もあります。

これら以外にも、以下のような問題があります。

• Internet Explorer で [ファイルのダウンロード] ダイアログ ボックスが 2 つ表示される
• [FIX] Content-Disposition: Attachment の使用時、拡張子が不明な場合に誤ったファイル名で保存される
• [FIX] 既知の内容の種類に対して "Content-Disposition: Attachment" が機能しない
• FIX: Content-Disposition: Does not Force File Download Dialog
• [IE] Content-Disposition: attachment でファイルをダウンロードするとフレームが更新されなくなる
• [ファイルを開く] または [ファイルの保存] ダイアログ ボックスに表示されるファイル名が正しくない
• [FIX] ファイルのダウンロードを何回か中止すると IE が応答しなくなる
• [IE] [開く] および [名前を付けて保存] ダイアログ ボックスで、複数のピリオドの付いたファイルに対して修飾されたファイル名が使用される
• マイクロソフトサイト内の"Content-Disposition"の検索

参考 †

• [HOWTO] 既知の MIME タイプに対し [ファイルのダウンロード] ダイアログ ボックスを開く
• ファイルのダウンロードダイアログで表示されるファイル名の命名規則
• FIX: ASP.NET で Response.Addheader メソッドを使用すると、応答ヘッダーが UTF-8 として常にエンコードされます。