Export (0) Print
Expand All

Controller.File Method (Byte(), String, String)

Creates a FileContentResult object using the file contents, content type, and the target file name.

Namespace:  System.Web.Mvc
Assembly:  System.Web.Mvc (in System.Web.Mvc.dll)

'Declaration
Protected Friend Overridable Function File ( _
	fileContents As Byte(), _
	contentType As String, _
	fileDownloadName As String _
) As FileContentResult
'Usage
Dim fileContents As Byte()
Dim contentType As String
Dim fileDownloadName As String
Dim returnValue As FileContentResult

returnValue = Me.File(fileContents, _
	contentType, fileDownloadName)

Parameters

fileContents
Type: System.Byte()
The binary content to send to the response.
contentType
Type: System.String
The content type (MIME type).
fileDownloadName
Type: System.String
The file name to display in the file-download dialog box that is displayed in the browser.

Return Value

Type: System.Web.Mvc.FileContentResult
The file content result object.

The fileDownloadName parameter is used to generate the content-disposition header. The content-disposition header must use US ASCII encoding. Therefore, the fileDownloadName parameter must use US ASCII encoding. The result object that is prepared by this method is written to the response by the MVC framework when the object is executed. The MediaTypeNames class can be used to get the MIME type for a particular file extension.

The following example shows how to open a file-download dialog box and set the file name to the name of the server file. The id parameter contains the server file name.

Public Function ShowFileDLN(ByVal id As String) As ActionResult 
    Dim fd As fileDetail = getFileDetails(id) 
    Return File(fd.fileBytes, fd.mimeType, id) 
End Function  

Community Additions

Show:
© 2014 Microsoft