Udostępnij za pośrednictwem


httpRuntime elementu (ASP.Schemat ustawień netto)

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Konfiguruje ASP.Ustawienia run-time NET HTTP, które określają sposób przetwarzania żądania dla aplikacji ASP.NET aplikacji.

<httpRuntime
   apartmentThreading = "[True|False]"
   appRequestQueueLimit = "number"
   delayNotificationTimeout = "number"
   enable = "[True|False]" 
   enableHeaderChecking = "[True|False]" 
   enableKernelOutputCache = "[True|False]" 
   enableVersionHeader = "[True|False]" 
   encoderType = "string"
   executionTimeout = "number" 
   maxQueryStringLength = "number"
   maxRequestLength = "number" 
   maxUrlLength = "number"
   maxWaitChangeNotification = "number" 
   minFreeThreads = "number" 
   minLocalRequestFreeThreads = "number" 
   relaxedUrlToFileSystemMapping = "[True|False]"
   requestLengthDiskThreshold = "number" 
   requestPathInvalidCharacters = "string"
   requestValidationMode = "[2.0|4.0]"
   requestValidationType = "string"
   requireRootedSaveAsPath = "[True|False]"
   sendCacheControlHeader = "[True|False]" 
   shutdownTimeout = "number"
   targetFramework = "number"   useFullyQualifiedRedirectUrl = "[True|False]" 
   waitChangeNotification = "number" />

Atrybuty i elementy

Poniżej opisano atrybuty i elementy podrzędne elementy nadrzędne.

Atrybuty

Atrybut

Opis

apartmentThreading

Opcjonalny Boolean atrybut.

Umożliwia wątkowość zgodnooć Klasyczne ASP.

Wartością domyślną jest False.

appRequestQueueLimit

Opcjonalny Int32 atrybut.

Określa maksymalną liczbę żądań ASP.NET kolejki aplikacji. Jeśli nie ma wystarczającej liczby wolnych wątków do przetworzenia żądania, żądania są umieszczane w kolejce. Żądania przychodzące są odrzucane z powodu błędu "503 — Serwer jest zbyt zajęty" kiedy kolejki przekroczy limit, określona w ten atrybut.

Wartość domyślna to 5000.

delayNotificationTimeout

Opcjonalny Int32 atrybut.

Określa limit czasu w sekundach dla opóźnienia powiadomień.

Wartość domyślna to 5 sekund.

encoderType

Pobiera lub ustawia nazwę niestandardowego typu, które mogą być używane dojście HTML i kodowanie adresów URL.

ASP.NET używa HttpEncoder typu jako domyślnego programu obsługi zadań kodowania HTML i adres URL. Aby dostosować zachowanie kodowania, można utworzyć klasy, która dziedziczy z HttpEncoder typu. W pliku konfiguracyjnym aplikacji, następnie ustaw EncoderType atrybutu httpRuntime element string w pełni kwalifikowaną nazwę niestandardowego typu.

Ten atrybut jest nowego w.NET Framework w wersji 4.0.

enable

Opcjonalny Boolean atrybut.

Określa, czy domena aplikacji (AppDomain) jest włączony do akceptowania żądań przychodzących na poziomie bieżącego węzła i węzeł podrzędny. Jeśli False, aplikacja jest skutecznie wyłączone.

Wartością domyślną jest True.

enableHeaderChecking

Opcjonalny Boolean atrybut.

Określa, czy ASP.NET, należy sprawdzić w nagłówku żądania potencjalne ataki. Jeśli atak zostaje wykryty, ASP.NET odpowiada błąd.

Wartością domyślną jest True.

enableKernelOutputCache

Opcjonalny Boolean atrybut.

Określa, czy włączone jest buforowanie danych wyjściowych. Ten atrybut ma zastosowanie tylko w przypadku, gdy Microsoft Internet Information Services (IIS) 6.0 lub nowszy jest zainstalowany. Dane wyjściowe, buforowanie, konfiguracji i typ żądania określa, czy zawartość może być buforowana.

W pamięci podręcznej odpowiedzi, muszą być spełnione następujące kryteria:

  • Buforowanie musi być jawnie włączone przez dyrektywy strony lub za pomocą interfejsu API buforowania.

  • Buforowanie musi mieć zasadę wygasania, tak, że jądro rozpoznaje, kiedy należy odrzucić odpowiedź.

  • Buforowanie nie ma żadnych nagłówków zmiennych lub parametrów.

  • Uwierzytelnianie nie jest wymagane.

Wartością domyślną jest True.

enableVersionHeader

Opcjonalny Boolean atrybut.

Określa, czy ASP.NET należy wyprowadzić nagłówka wersji. Ten atrybut jest używany przez Microsoft Visual Studio 2005 wersji programu ASP.NET jest używana. To nie jest konieczne dla miejsc produkcji i można wyłączyć.

NoteNote
Ten atrybut nie jest dostępna w.NET Framework 1.0.

Wartością domyślną jest True.

executionTimeout

Opcjonalny Int32 atrybut.

Określa maksymalną liczbę sekund, które żądanie może wykonać, zanim zostanie automatycznie zamknięte przez program ASP.NET.

Ten limit czasu stosuje się tylko wtedy, gdy atrybut debugowania w compilation jest elementem False . Dlatego jeśli debug atrybut jest True , nie trzeba ustawić atrybut na dużą wartość w celu uniknięcia zamknięcie aplikacji podczas debugowania.

Wartość domyślna wynosi 110 sekund.

maxRequestLength

Opcjonalny Int32 atrybut.

Określa limit dla strumienia wejściowego buforowanie próg, w KB. Ten limit, można zapobiec atakom typu odmowa usługi, które są spowodowane, na przykład przez użytkowników przesyłających duże pliki do serwera.

Wartością domyślną jest 4096 KB. Jeśli próg został przekroczony, ConfigurationErrorsException jest wyjątek.

maxWaitChangeNotification

Opcjonalny Int32 atrybut.

Określa maksymalną liczbę sekund oczekiwania z pierwszego powiadomienia o zmianie pliku przed ponownym uruchomieniem AppDomain dla nowego żądania. Ustaw ten atrybut na liczbę jest większa niż długość czasu na zakończenie wszystkich procesów kopię pliku. Powiadomienia o zmianie plików są połączone na podstawie wartości tego atrybutu i waitChangeNotification atrybut.

Wartością domyślną jest 0.

minFreeThreads

Opcjonalny Int32 atrybut.

Określa minimalną liczbę wolnych wątków, aby umożliwić obsługę nowych żądań. ASP.NET zachowuje określona liczba wolnych wątków dla żądań, które wymagają dodatkowych wątków do ukończenia przetwarzania.

Wartością domyślną jest 8.

minLocalRequestFreeThreads

Opcjonalny Int32 atrybut.

Określa minimalną liczbę wolnych wątków ASP.NET zachowuje dostępnych umożliwia wykonanie nowych żądań lokalnych. Określona liczba wątków jest zarezerwowana dla żądań, pochodzące z hosta lokalnego, w przypadku, gdy niektóre żądania generowały żądania podrzędne skierowane do hosta lokalnego podczas przetwarzania. Pomaga to zapobiec możliwe zakleszczenie ze zwrotnym do serwera sieci Web.

Wartością domyślną jest 4.

requestValidationMode

Opcjonalny Int32 atrybut.

Pobiera lub ustawia numer wersji, która wskazuje, które ASP.NET podejście określonej wersji do sprawdzania poprawności będą używane.

Wartością, którą należy przypisać do tej właściwości nie jest zatwierdzona do określonej wersji programu ASP.NET. Mniejsze niż wartość liczbowa 4.0 (na przykład3.7, 2.9, lub 2.0) jest interpretowana jako 2.0. Wszystkie liczby większe niż 4.0 jest interpretowana jako 4.0.

Wartością domyślną jest 4.0.

requestValidationType

Opcjonalny String atrybut.

Pobiera lub ustawia nazwę typu, który jest używany do sprawdzania poprawności żądań HTTP.

Aby dostosować ASP.Zachowanie poprawności żądania netto, można utworzyć klasy, która dziedziczy z RequestValidator typu. W pliku konfiguracyjnym aplikacji, następnie ustaw requestValidationType atrybutu httpRuntime element string w pełni kwalifikowaną nazwę niestandardowego typu

Domyślnie jest w pełni kwalifikowanej nazwy RequestValidator wpisz program ASP.NET używa do sprawdzania poprawności

requestLengthDiskThreshold

Opcjonalny Int32 atrybut.

Określa limit dla strumienia wejściowego buforowanie próg, w kilobajtach. Wartość ta nie powinna przekraczać maxRequestLength atrybut.

Wartością domyślną jest 80 KB.

requireRootedSaveAsPath

Opcjonalny Boolean atrybut.

Określa, czy filename parametr w SaveAs metoda musi być ścieżką bezwzględną. ASP.NET proces musi mieć uprawnienia do tworzenia plików w określonej lokalizacji.

Wartością domyślną jest True.

sendCacheControlHeader

Opcjonalny Boolean atrybut.

Określa, czy można wysłać nagłówka kontroli pamięci podręcznej, jest ustawiona na Private, domyślnie. Jeśli True, buforowanie po stronie klienta jest wyłączone.

Wartością domyślną jest True.

shutdownTimeout

Opcjonalny Int32 atrybut.

Określa liczbę minut, które są dozwolone dla procesu roboczego do zamknięcia. Po wygaśnięciu limitu czasu, ASP.NET zamyka proces roboczy.

Wartość domyślna to 90 sekund.

targetFramework

Opcjonalny String atrybut.

Określa numer wersji, który wskazuje, w których ramach określonej wersji środowiska wykonawczego języka wspólnego (CLR) będzie używany. Jeśli ten atrybut zostanie pominięty, ramy docelowych ustawiono 4.0.

Wartością domyślną jest Null.

useFullyQualifiedRedirectUrl

Opcjonalny Boolean atrybut.

Określa, czy przekierowania po stronie klienta są w pełni kwalifikowane przy użyciu formularza "https://server/path", który jest wymagany przez niektóre formanty mobilne lub czy przekierowania względne są wysyłane do klienta zamiast. Jeśli True, wszystkich przekierowań, które nie są w pełni kwalifikowaną są automatycznie konwertowane na format w pełni kwalifikowany.

NoteNote
Jeśli ten atrybut jest ustawiony na False, niektóre przeglądarki mogą wystąpić problemy podczas ładowania stron, które są w sesjach cookieless.

Wartością domyślną jest False.

waitChangeNotification

Opcjonalny Int32 atrybut.

Określa czas w sekundach oczekiwania na powiadomienie o zmianie pliku innym przed ponownym uruchomieniem elementu AppDomain. Ten atrybut jest ustawiony na liczbę, która jest większa niż czas między aktualizacjami kopii pliku dwa powiadomienia o zmianach. Powiadomienia o zmianie plików są połączone na podstawie wartości tego atrybutu i maxWaitChangeNotification atrybut.

Wartością domyślną jest 0 sekund.

maxQueryStringLength

Opcjonalny Int32 atrybut.

Maksymalna długość ciągu kwerendy w znakach. Wartość domyślna to 2048.

Wartość MaxQueryStringLength właściwość może być liczbą całkowitą, zero lub większą. Jeśli długość ciągu kwerendy przekracza limit rozmiaru, ASP.NET zwraca HTTP 400 (niewłaściwe żądanie) kod stanu.

NoteNote
Bardzo małe wartości można wprowadzić witryny sieci Web bezużyteczny.
NoteNote
Istnieje również ustawienie usług IIS, który steruje długość ciągu kwerendy.Zobacz maxQueryString atrybutu w Limity żądania <requestLimits>.

maxUrlLength

Opcjonalny Int32 atrybut.

Maksymalna długość adresu URL w znakach. Wartość domyślna wynosi 260.

Wartość MaxUrlLength właściwość może być liczbą całkowitą, zero lub większą.

Jeśli długość adresu URL żądania (która jest wartością Path właściwość) przekracza skonfigurowany limit rozmiaru, ASP.NET zwraca kod stanu HTTP 400 (niewłaściwe żądanie)

NoteNote
Bardzo małe wartości można wprowadzić witryny sieci Web bezużyteczny. Istnieje również ustawienie usług IIS, który steruje długość ciągu kwerendy.Zobacz maxQueryString atrybutu w Limity żądania <requestLimits>.

relaxedUrlToFileSystemMapping

Opcjonalny Boolean atrybut.

Wskazuje, czy adres URL w żądaniu HTTP musi być prawidłową ścieżkę pliku systemu Windows.

RelaxedUrlToFileSystemMapping Właściwość określa sposób weryfikacji adresu URL na przychodzące żądanie HTTP. Jeśli ta właściwość jest false, adres URL jest sprawdzany przy użyciu tej samej zasady, określające, czy ścieżka systemu plików Windows jest nieprawidłowy.

requestPathInvalidCharacters

Opcjonalny String atrybut.

Rozdzielana przecinkami lista znaków, które są nieprawidłowe w ścieżce żądania. Poniższa lista zawiera domyślny zestaw nieprawidłowych znaków:

<,>,*,%,&,:,\

Elementy podrzędne

Brak.

Elementy nadrzędne

Element

Opis

configuration

Element główny wymagane w każdym pliku konfiguracyjnym, używany przez common language runtime i.NET Framework aplikacji.

system.web

Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w konfiguracji pliku i zawiera elementy konfiguracyjne określające konfigurację programu ASP.NET oraz kontrolować zachowanie aplikacji.

Uwagi

httpRuntime Element konfiguruje ASP.Ustawienia run-time NET HTTP, które określają, w jaki sposób żądania dla aplikacji ASP.NET aplikacji jest przetwarzane. .NET Framework zapewnia szereg różnych hostów run-time, łącznie z ASP.Host czasu netto. Gdy nadejdzie żądanie w ASP.NET ładuje ustawienia czasu z procesem jest do obsługi żądania. ASP.NET również tworzy domenę aplikacji dla każdej aplikacji sieci Web, który będzie uruchamiany na serwerze sieci Web.

Domyślna konfiguracja

httpRuntime Element nie jest jawnie zdefiniowane w pliku Machine.config lub głównego pliku Web.config. Jednak następujące ustawienia są wartości domyślne, jak zainicjowany przez system. Jeśli konieczne jest dostosowanie tej sekcji należy utworzyć go w pliku konfiguracji i zdefiniować tylko te atrybuty, które wymagają dostosowania.

<httpRuntime 
   apartmentThreading="false"
   appRequestQueueLimit="5000"
   delayNotificationTimeout="5"
   enable="true"
   enableHeaderChecking="true"
   enableKernelOutputCache="true"
   enableVersionHeader="true"
   encoderType = "System.Web.Util.HttpEncoder"
   executionTimeout="110"
   maxQueryStringLength = "2048"
   maxRequestLength="4096"
   maxUrlLength = "260"
   maxWaitChangeNotification="0"
   minFreeThreads="8"
   minLocalRequestFreeThreads="4"
   relaxedUrlToFileSystemMapping = "False"
   requestLengthDiskThreshold="80"
   requestPathInvalidCharacters = "<,>,*,%,&,:,\"
   requestValidationMode = "4.0"
   requestValidationType = "System.Web.Util.RequestValidator"
   requireRootedSaveAsPath="true"
   sendCacheControlHeader="true"
   shutdownTimeout="90"
   useFullyQualifiedRedirectUrl="false"
   waitChangeNotification="0" />

Przykład

Poniższy przykład ilustruje sposób określić parametry czasu wykonywania HTTP dla aplikacji ASP.NET aplikacji.

<configuration>
  <system.web>
  <httpRuntime maxRequestLength="4000"
    enable = "True"
    requestLengthDiskThreshold="512
    useFullyQualifiedRedirectUrl="True"
    executionTimeout="45"
    versionHeader="1.1.4128"/>
  </system.web>
</configuration>

Informacje o elementach

Program obsługi sekcji konfiguracji

HttpRuntimeSection

Członkowskie konfiguracji

HttpRuntime

Lokalizacje konfigurowalne

Machine.config

Web.config na poziomie katalogu głównego

Poziom aplikacji Web.config

Directory–level wirtualnego lub fizycznego Web.config

Wymagania

Microsoft Internet Information Services (IIS) 5.0 lub nowszy

Zobacz też

Informacje

System.Web elementu (ASP.Schemat ustawień netto)

Konfiguracja elementu (schemat ustawień ogólne)

System.Configuration

HttpRuntimeSection

HttpRuntime

Koncepcje

Securing Configuration

Inne zasoby

Ogólne ustawienia konfiguracji (ASP.(NET)

Configuring ASP.NET Applications