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 multipart/form-data. По умолчанию все запросы, включая поля форм и отправленные файлы, размером более 256 КБ, помещаются в буфер на диск, а не хранятся в памяти сервера.

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

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