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) |