HttpPostedFile HttpPostedFile HttpPostedFile HttpPostedFile Class

Определение

Предоставляет доступ к отдельным файлам, загруженным клиентом.Provides access to individual files that have been uploaded by a client.

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

Комментарии

HttpFileCollection Класс предоставляет доступ ко всем файлам, которые передаются из клиента в виде коллекции файлов.The HttpFileCollection class provides access to all the files that are uploaded from a client as a file collection. HttpPostedFile Класс предоставляет свойства и методы для получения сведений о отдельном файле, а также для чтения и сохранения файла.The HttpPostedFile class provides properties and methods to get information about an individual file and to read and save the file.

HtmlInputFile Элемент управления можно использовать для выбора и передачи файлов из клиента.The HtmlInputFile control can be used to select and upload files from a client.

Файлы передаются в формате MIME multipart/form-data.Files are uploaded in MIME multipart/form-data format. По умолчанию все запросы, включая поля форм и отправленные файлы размером более 256 КБ, помещаются в буфер на диск, а не в память сервера.By default, all requests, including form fields and uploaded files, larger than 256 KB are buffered to disk, rather than held in server memory.

Можно указать максимально допустимый размер запроса, обратившись к MaxRequestLength свойству или maxRequestLength задав атрибут элемента httpRuntime (схема параметров ASP.NET) в файле Machine. config или Web. config.You can specify the maximum allowable request size by accessing the MaxRequestLength property or by setting the maxRequestLength attribute of the httpRuntime Element (ASP.NET Settings Schema) element within the Machine.config or Web.config file. Значение по умолчанию — 4 МБ.The default is 4 MB.

Объем данных, помещенных в буфер памяти сервера для запроса, который включает передачи файлов, можно задать с помощью доступа к RequestLengthDiskThreshold свойству или путем requestLengthDiskThreshold установки атрибута элемента httpRuntime (схема параметров ASP.NET) . в файле Machine. config или Web. config.The amount of data that is buffered in server memory for a request, which includes file uploads, can be specified by accessing the RequestLengthDiskThreshold property or by setting the requestLengthDiskThreshold attribute of the httpRuntime Element (ASP.NET Settings Schema) element within the Machine.config or Web.config file.

Настраивая MaxRequestLength свойства и RequestLengthDiskThreshold , можно точно настроить производительность сервера.By adjusting the MaxRequestLength and RequestLengthDiskThreshold properties, you can fine tune the performance of your server. Кроме того, следует рассмотреть возможность установки MaxRequestLength параметра для предотвращения атак типа «отказ в обслуживании», вызванных тем, что пользователи публикуют большие файлы на сервере.Additionally, you should consider setting the MaxRequestLength to prevent denial of service attacks caused by users posting large files to the server.

Ресурсы сервера, выделенные для буферизации отправленного файла, будут уничтожены после завершения запроса.Server resources that are allocated to buffer the uploaded file will be destroyed when the request ends. Чтобы сохранить устойчивую копию файла, используйте SaveAs метод.To save a durable copy of the file, use the SaveAs method.

Свойства

ContentLength ContentLength ContentLength ContentLength

Возвращает размер загруженного файла в байтах.Gets the size of an uploaded file, in bytes.

ContentType ContentType ContentType ContentType

Возвращает тип содержимого MIME файла, отправленного клиентом.Gets the MIME content type of a file sent by a client.

FileName FileName FileName FileName

Возвращает полностью определенное имя файла клиента.Gets the fully qualified name of the file on the client.

InputStream InputStream InputStream InputStream

Возвращает объект Stream, который указывает на загруженный файл для подготовки прочтения его содержимого.Gets a Stream object that points to an uploaded file to prepare for reading the contents of the file.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SaveAs(String) SaveAs(String) SaveAs(String) SaveAs(String)

Сохраняет содержимое загруженного файла.Saves the contents of an uploaded file.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

Дополнительно