HttpPostedFile Класс

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

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

public ref class HttpPostedFile sealed

public sealed class HttpPostedFile

type HttpPostedFile = class

Public NotInheritable Class HttpPostedFile

Наследование

Object

HttpPostedFile

Комментарии

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

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

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

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

Объем данных, буферизированных в памяти сервера для запроса, включающего отправку файлов, можно указать путем доступа к RequestLengthDiskThreshold свойству или путем задания requestLengthDiskThreshold атрибута элемента httpRuntime (ASP.NET settings 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)

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

• HtmlInputFile
• HttpFileCollection