HttpPostedFile Класс

Определение

Предоставляет доступ к отдельным файлам, загруженным клиентом.

public ref class HttpPostedFile sealed
public sealed class HttpPostedFile
type HttpPostedFile = class
Public NotInheritable Class HttpPostedFile
Наследование
HttpPostedFile

Комментарии

Класс HttpFileCollection предоставляет доступ ко всем файлам, отправленным из клиента в виде коллекции файлов. Класс HttpPostedFile предоставляет свойства и методы для получения сведений об отдельном файле, а также для чтения и сохранения файла.

Элемент HtmlInputFile управления можно использовать для выбора и отправки файлов из клиента.

Файлы отправляются в формате MIME с несколькими частями или данными формы. По умолчанию все запросы, включая поля формы и отправленные файлы, больше 256 КБ буферизуются на диск, а не хранятся в памяти сервера.

Чтобы указать максимальный допустимый размер запроса, можно получить доступ к MaxRequestLength свойству или задать maxRequestLength атрибут элемента httpRuntime Element (ASP.NET Параметры Schema) в файле Machine.config или Web.config. Значение по умолчанию — 4 МБ.

Объем данных, буферизуемых в памяти сервера для запроса, включающего отправки файлов, можно указать путем доступа к RequestLengthDiskThreshold свойству или путем задания requestLengthDiskThreshold атрибута элемента httpRuntime (ASP.NET Параметры Schema) в Machine.config или файле Web.config.

Изменив MaxRequestLength параметры и RequestLengthDiskThreshold свойства, можно точно настроить производительность сервера. Кроме того, следует задать параметр MaxRequestLength для предотвращения атак типа "отказ в обслуживании", вызванных пользователями, публикующими большие файлы на сервере.

Ресурсы сервера, выделенные для буфера отправленного файла, будут уничтожены при завершении запроса. Чтобы сохранить устойчивую копию файла, используйте SaveAs метод.

Свойства

ContentLength

Возвращает размер отправленного файла в байтах.

ContentType

Возвращает тип содержимого MIME файла, отправленного клиентом.

FileName

Получает полное имя файла на стороне клиента.

InputStream

Получает объект Stream, который указывает на отправленный файл для подготовки к чтению содержимого файла.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
SaveAs(String)

Сохраняет содержимое отправленного файла.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел