HttpPostedFile Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapewnia dostęp do poszczególnych plików, które zostały przekazane przez klienta.
public ref class HttpPostedFile sealed
public sealed class HttpPostedFile
type HttpPostedFile = class
Public NotInheritable Class HttpPostedFile
- Dziedziczenie
-
HttpPostedFile
Uwagi
Klasa HttpFileCollection zapewnia dostęp do wszystkich plików przekazywanych z klienta jako kolekcji plików. Klasa HttpPostedFile udostępnia właściwości i metody umożliwiające uzyskanie informacji o pojedynczym pliku oraz odczytywanie i zapisywanie pliku.
Kontrolka może służyć do wybierania HtmlInputFile i przekazywania plików z klienta.
Pliki są przekazywane w formacie wieloczęściowym/formularz-danych MIME. Domyślnie wszystkie żądania, w tym pola formularza i przekazane pliki, większe niż 256 KB są buforowane na dysku, a nie przechowywane w pamięci serwera.
Maksymalny dozwolony rozmiar żądania można określić, korzystając z właściwości lub ustawiając MaxRequestLengthmaxRequestLength
atrybut elementu httpRuntime (schemat ustawień ASP.NET) w pliku Machine.config lub Web.config. Wartość domyślna to 4 MB.
Ilość danych buforowanych w pamięci serwera dla żądania, które obejmuje przekazywanie plików, można określić przez uzyskanie dostępu do RequestLengthDiskThreshold właściwości lub ustawienie requestLengthDiskThreshold
atrybutu elementu httpRuntime (schematu ustawień ASP.NET) w pliku Machine.config lub Web.config.
Dostosowując MaxRequestLength właściwości i RequestLengthDiskThreshold , można dostosować wydajność serwera. Ponadto należy rozważyć ustawienie elementu MaxRequestLength , aby zapobiec atakom typu "odmowa usługi" spowodowanym przez użytkowników publikując duże pliki na serwerze.
Zasoby serwera przydzielone do buforowania przekazanego pliku zostaną zniszczone po zakończeniu żądania. Aby zapisać trwałą kopię pliku, użyj SaveAs metody .
Właściwości
ContentLength |
Pobiera rozmiar przekazanego pliku w bajtach. |
ContentType |
Pobiera typ zawartości MIME pliku wysyłanego przez klienta. |
FileName |
Pobiera w pełni kwalifikowaną nazwę pliku na kliencie. |
InputStream |
Stream Pobiera obiekt wskazujący przekazany plik w celu przygotowania się do odczytu zawartości pliku. |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
SaveAs(String) |
Zapisuje zawartość przekazanego pliku. |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |