strony elementu (ASP.Schemat ustawień netto)

Artykuł
06/25/2012

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

Globalnie definiuje ustawienia konfiguracji specyficzne dla strony, takie jak ASP.NET dyrektyw dla stron i formantów, które są w ramach zakresu pliku konfiguracyjnego.

<pages     
   asyncTimeout="number"
   autoEventWireup="[True|False]"
   buffer="[True|False]"
   clientIDMode="[AutoID|Predictable|Static]"
   compilationMode="[Always|Auto|Never]" 
   controlRenderingCompatibilityVersion="[3.5|4.0]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   maintainScrollPositionOnPostBack="[True|False]" 
   masterPageFile="file path" 
   maxPageStateFieldLength="number" 
   pageBaseType="typename, assembly"
   pageParserFilterType="string" 
   renderAllHiddenFieldsAtTopOfForm="[True|False]"
   smartNavigation="[True|False]"
   styleSheetTheme="string"
   theme="string"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   viewStateEncryptionMode="[Always|Auto|Never]" 
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
   <ignoreDeviceFilters>...</ignoreDeviceFilters>
</pages>

Atrybuty i elementy

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

Atrybuty

Atrybut	Opis
asyncTimeout	Opcjonalny TimeSpan atrybut. Określa liczbę sekund oczekiwania na asynchroniczne obsługi ukończyć podczas przetwarzania asynchronicznego. Ten atrybut jest nowego w.NET Framework w wersji 2.0. Wartością domyślną jest "0:00:45" (45 sekund).
autoEventWireup	Opcjonalny Boolean atrybut. Określa, czy zdarzenia strony są automatycznie włączane. Jest to, jeśli występuje, auto zdarzenia są dopasowywane, co oznacza system automatycznie wstawi metody określonym podpisem (Page_Load na przykład). Aby uzyskać więcej informacji, zobacz ASP.NET Server Control Event Model. Wartością domyślną jest True.
buffer	Opcjonalny Boolean atrybut. Określa, czy zasób URL stosuje buforowanie odpowiedzi. Wartością domyślną jest True.
clientIDMode	Określa algorytm generowania ClientID wartości dla formantów. Wartością domyślną jest Predictable. Wartość domyślna dla formantów jest Inherit. Dlatego ustala domyślny algorytm formantów na stronie ClientIDMode ustawienia strony. Można ustawić wartości domyślne różnych w @ Page w dyrektywie strony lub w @ Control dyrektywa kontroli użytkownika. Aby uzyskać więcej informacji na temat algorytmów, zobacz ClientIDMode i ASP.NET Control Identification.
compilationMode	Opcjonalny CompilationMode atrybut. Określa, czy aplikacja ASP.Strona netto lub kontroli powinny zostać opracowane w czasie wykonywania. compilationMode Atrybut jest nowego w.NET Framework 2.0. Ten atrybut może być jedną z następujących możliwych wartości. Wartością domyślną jest Always. WartośćOpis Always Zawsze należy sporządzić strony. Auto ASP.NET będzie nie kompilować strony, jeśli jest to możliwe. Never Nigdy nie należy dynamicznie sporządzić strony lub formantu. Jeśli strona zawiera blok skryptu lub skonstruowania kod, który wymaga kompilacji, ASP.NET zwróci błąd i strona nie będzie działać.
controlRenderingCompatibilityVersion	Określa, czy formanty powinny renderowania HTML ulegają we wcześniejszej wersji programu ASP.NET lub sposób są one przeznaczone do w bieżącej wersji. Note controlRenderingCompatibilityVersion Nowego w ASP.NET 4.Ustawienie to numer wersji ma taki sam skutek jak nie zostanie ustawienie.W każdym przypadku formanty renderowania HTML zaprojektowane dla bieżącej wersji.Najwcześniejsza wersja, który można ustawić ten atrybut jest 3.5. Aby uzyskać więcej informacji, zobacz PagesSection.ControlRenderingCompatibilityVersion i Control.RenderingCompatibility właściwości.
enableEventValidation	Określa, czy strony i formanty poprawności zdarzenia odświeżania strony i wywołania zwrotnego. Wartością domyślną jest True.
enableSessionState	Opcjonalny String atrybut. Określa wymagania stanu sesji dla zasobów, które są objęte zakresem pliku konfiguracji. enableSessionState Atrybut może być jedną z następujących możliwych wartości. Wartością domyślną jest True. WartośćOpis False Wskazuje, że stan sesji jest wyłączony. ReadOnly Wskazuje, że stan sesji nie jest zapisywalny. True Wskazuje, że stan sesji jest włączony.
enableViewState	Opcjonalny Boolean atrybut. Określa, czy stan widoku jest włączona i zachowywana żądania stron. Wartością domyślną jest True.
enableViewStateMac	Opcjonalny Boolean atrybut. Określa, czy ASP.NET powinno uruchamiać kod uwierzytelniania wiadomości (MAC) na stan widoku strony, strony po zaksięgowaniu wstecz od klienta. Jeśli True, zaszyfrowany stan widoku jest sprawdzany, aby zweryfikować, że nie został zmodyfikowany z klienta. Wartością domyślną jest True.
maintainScrollPositionOnPostBack	Opcjonalny Boolean atrybut. Określa, czy powrócić do tej samej pozycji w przeglądarce klienta użytkownika, gdy strony są księgowane na serwer. Jeśli False, użytkownik wraca do góry strony odświeżenie strony. Ten atrybut jest nowego w.NET Framework 2.0. Wartością domyślną jest False.
masterPageFile	Opcjonalny String atrybut. Określa ścieżkę strony wzorcowej do lokalnego pliku konfiguracji. Strony, które mają masterPageFile atrybut ustawiony na True musi zawierać Content formantu jako formantu najwyższego poziomu Ten atrybut jest nowego w.NET Framework 2.0. Wartością domyślną jest ciąg pusty ("").
maxPageStateFieldLength	Opcjonalny Int32 atrybut. Określa maksymalną długość w znakach w polu Stan dla strony. Jeśli ustawiona na wartość dodatnią, pola stanu widoku, które są wysyłane do przeglądarki klienta jest podzielony na fragmenty, i każdy fragment jest mniejsza niż wielkość określona w maxPageStateFieldLength atrybut. Jeśli ustawiono wartość ujemną, pole stan widoku nie powinny być rozdzielane na kawałki. Ten atrybut jest nowego w.NET Framework 2.0. Wartością domyślną jest "-1".
pageBaseType	Opcjonalny String atrybut. Określa podstawy do użycia podczas tylko strony są autonomiczne. Jest przesłaniany przez inherits atrybut w pliku autonomicznych. Wartością domyślną jest "System.Web.UI.Page".
pageParserFilterType	Opcjonalny String atrybut. Określa nazwę typu filtru, który jest używany przez ASP.Parser netto do ustalenia, czy element jest dozwolone na stronie w czasie analizy. Filtr musi pochodzić od PageParserFilter klasy. Ten atrybut jest nowego w.NET Framework 2.0. Wartością domyślną jest ciąg pusty ("").
renderAllHiddenFieldsAtTopOfForm	Opcjonalny Boolean atrybut. Określa, czy wszystkie wygenerowane przez system ukryte pola są renderowane w górnej części formularza. Ten atrybut jest nowego w.NET Framework 3.5. Wartością domyślną jest True.
smartNavigation	Opcjonalny Boolean atrybut. Określa, czy jest włączona inteligentna nawigacja. Inteligentna nawigacja wymaga programu Microsoft Internet Explorer w wersji 5.5 lub nowszej. Gdy jest włączona inteligentna nawigacja użytkownik zauważa następujące korzyści: BŁYSK nawigacyjnych jest wyeliminowane. Przewijanie jest zachowywane między Stronami. Element fokus jest zachowywane między Stronami. Ostatni stan strony jest jedynym Państwem zatrzymane przez historii w przeglądarce. Ten atrybut jest nowego w.NET Framework 2.0, ale została zaniechana na korzyść z maintainScrollPositionOnPostBack atrybut. Wartością domyślną jest False.
styleSheetTheme	Opcjonalny String atrybut. Określa nazwę folderu "theme nazwanego", aby zastosować motyw przed deklaracje kontroli, w odróżnieniu od atrybutu motywu, który definiuje motywu po kontroli zgłoszenia. Ten atrybut jest nowego w.NET Framework 2.0. Wartością domyślną jest ciąg pusty ("").
theme	Opcjonalny String atrybut. Określa nazwę motywu, który jest używany dla stron, które są objęte zakresem pliku konfiguracji. Zdefiniowana kompozycja musi istnieć jako aplikacji lub globalnych motywu. Jeśli kompozycja nie istnieje, HttpException jest wyjątek. Ten atrybut jest nowego w.NET Framework 2.0. Wartością domyślną jest ciąg pusty ("").
userControlBaseType	Opcjonalny String atrybut. Określa podstawy do użycia podczas tylko strony są autonomiczne. Wartością domyślną jest "System.Web.UI.UserControl".
validateRequest	Opcjonalny Boolean atrybut. Wskazuje, że program ASP.NET analizuje wszystkie dane wejściowe z przeglądarki dla potencjalnie niebezpiecznych danych. Jeśli True, sprawdzanie poprawności żądań jest przeprowadzana przez porównywanie wszystkich danych wejściowych z listą potencjalnie niebezpiecznych wartości. Jeśli pasują, ASP.NET podbicia HttpRequestValidationException wyjątku. Wartością domyślną jest True.
viewStateEncryptionMode	Opcjonalny ViewStateEncryptionMode atrybut. Określa tryb szyfrowania stanu widoku. ViewStateEncryptionMode Właściwość zastępuje ten atrybut, który jest określony w pliku konfiguracji. Ten atrybut może być jedną z następujących możliwych wartości. WartośćOpis Always Stan widoku są zawsze szyfrowane. Auto Stan widoku jest szyfrowane, jeżeli formant o to wnioskuje. Never Stan widoku nigdy nie są szyfrowane, nawet wtedy, gdy formant tego zażądają. Ten atrybut jest nowego w.NET Framework 2.0. Wartością domyślną jest Auto.

Elementy podrzędne

Element	Opis
controls	Określa zbiór dyrektywach register i obszary nazw, w którym znajdują się prefiksy znaczników.
namespaces	Określa zbiór dyrektyw importu podczas wstępnej kompilacji zestawu.
tagMapping	Określa zbiór typów znaczników, które są mapowane ponownie do innych typów znaczników w czasie kompilacji.
ignoreDeviceFilters	Określa zbiór elementów urządzenia jest renderowane że przeglądarki należy zignorować stronę. Aby uzyskać więcej informacji, zobacz IgnoreDeviceFilters.

Elementy nadrzędne

Element	Opis
configuration	Element główny wymagane w każdym pliku konfiguracyjnym, używany przez common language runtime i.NET Programowanie 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

pages Element definiuje ustawienia konfiguracji specyficzne dla strony. Ta sekcja konfiguracji obsługuje ustawienie niektórych ASP.NET dyrektyw strony i kontroli globalnie dla wszystkich stron i formantów w zakresie pliku konfiguracyjnego. Obejmuje to następujące dyrektywy na poziomie strony, które określają ustawienia używane przez strony i kontrola użytkownika kompilatory kompilatory proces ASP.Strony sieci Web Forms (.aspx) i pliki użytkownika w kontroli (.ascx):

@ Page Dyrektywy (@ Page).
@ Import Dyrektywy (@ Import) poprzez obszarów nazw element podrzędny.
@ Register Dyrektywy (@ Register) poprzez kontroli element podrzędny.

pages Element zapewnia także obsługę mapowania typów znaczników na inne typy znaczników w czasie wykonywania za pomocą tagMapping element.

Uwaga

Dodawanie @ Page dyrektywy na stronie wzorcowej nie pozwala używać tej samej dyrektywy deklaracji na stronach, które zależą od wzorca.Korzystaj z pages z konfiguracji elementu globalnie dyrektyw strony.

Domyślna konfiguracja

Następujące domyślne pages element nie jest jawnie skonfigurowane w pliku Machine.config lub głównego pliku Web.config. Jednakże jest domyślna konfiguracja zwróconego przez aplikację. Obszary nazw i formanty są dodawane w pliku Web.config w katalogu głównego.

<pages 
   buffer="true" 
   clientIDMode="AutoID" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

Przykład

Poniższy przykład kodu pokazuje jak określić kilka ustawień konfiguracyjnych strony.

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

Informacje o elementach

Program obsługi sekcji konfiguracji	PagesSection
Członkowskie konfiguracji	Pages Page
Lokalizacje konfigurowalne	Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config Wirtualnej lub fizycznej directory–level Web.config
Wymagania	Microsoft Internet Information Services (IIS) w wersji 5.0 lub nowszej .NET Framework w wersji 1.0 lub nowsza Microsoft Visual Studio 2003 lub nowszego

Zobacz też

Udostępnij za pośrednictwem

strony elementu (ASP.Schemat ustawień netto)

Atrybuty i elementy

Atrybuty

Elementy podrzędne

Elementy nadrzędne

Uwagi

Domyślna konfiguracja

Przykład

Informacje o elementach

Zobacz też

Zadania

Informacje

Koncepcje

Inne zasoby

Dodatkowe zasoby