pierwiastek śladowy (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.Usługa śledzenia netto kod kontroluje, w jaki sposób wyniki śledzenia są zbierane, przechowywane i wyświetlane.
<trace
enabled="true|false"
localOnly="true|false"
pageOutput="true|false"
requestLimit="integer"
mostRecent="true|false"
writeToDiagnosticsTrace="true|false"
traceMode="SortByTime|SortByCategory"
/>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.
Atrybuty
Atrybut |
Opis |
|---|---|
enabled |
Opcjonalny Boolean atrybut. Określa, czy śledzenie jest włączone dla aplikacji. Śledzenie musi być włączony do za pomocą podglądu Trace.axd. Domyślnie przeglądarka Trace.axd dodaje się do httpHandlers element. Wartością domyślną jest false. |
localOnly |
Opcjonalny Boolean atrybut. Określa czy przeglądarka śledzenia (Trace.axd) jest dostępna tylko na serwerze sieci Web hosta. Jeśli false, przeglądarka śledzenia jest dostępna z dowolnego komputera. Domyślnie przeglądarka Trace.axd dodaje się do httpHandlers element. Wartością domyślną jest true. |
mostRecent |
Opcjonalny Boolean atrybut. Określa, czy jest wyświetlane najnowsze dane wyjściowe śledzenia na poziomie aplikacji i starsze dane śledzenia poza granicami, które są wskazywane przez requestLimit jest odrzucany. Jeśli false, wyświetlane są dane śledzenia dla żądań aż do requestLimit atrybut zostanie osiągnięty. Ten atrybut jest nowego w.NET Framework w wersji 2.0. Wartością domyślną jest false. |
pageOutput |
Opcjonalny Boolean atrybut. Określa, czy wyniki śledzenia są podawane na końcu każdej strony. Jeśli false, wynik śledzenia jest dostępny za pośrednictwem tylko za pomocą narzędzia śledzenia. Wartością domyślną jest false. |
requestLimit |
Opcjonalny Int32 atrybut. Określa liczbę żądań śledzenia przechowywaną na serwerze. Jeśli zostanie osiągnięty limit czasu i mostRecent atrybut jest false, śledzenie jest automatycznie wyłączane. Limit maksymalnej żądań jest równa 10 000. Jeżeli określono wartość, która jest większa niż 10 000, to jest po cichu zaokrąglana w dół do 10 000 przez program ASP.NET. Wartością domyślną jest 10. |
traceMode |
Opcjonalny TraceDisplayMode atrybut. Określa kolejność wyświetlania informacji o śledzeniu. traceMode Atrybut może być jedną z następujących możliwych wartości.
WartośćOpis
SortByCategory Określa, że według kategorii zdefiniowanej przez użytkownika są wyświetlane alfabetycznie według informacji o śledzeniu.
SortByTime Określa, że informacje śledzenia są wyświetlane w kolejności, że informacje o śledzeniu jest przetwarzane.
Wartością domyślną jest SortByTime. |
writeToDiagnosticsTrace |
Opcjonalny Boolean atrybut. Określa, czy ASP.NET śledzenia wiadomości są przesyłane dalej do System.Diagnostics infrastruktury śledzenia, wszelkie detektorów, które są zarejestrowane do wyświetlania Trace wiadomości. Aby uzyskać więcej informacji, zobacz śledzenia elementu system.diagnostics. Ten atrybut jest nowego w.NET Framework w wersji 2.0. Wartością domyślną jest false. |
Elementy podrzędne
Brak.
Elementy nadrzędne
Element |
Opis |
|---|---|
configuration |
Element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.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 aplikacje sieci Web i kontrolować zachowanie tych aplikacji. |
Uwagi
Gdy włączone jest śledzenie, każde żądanie strony generuje komunikaty śledzenia, które mogą być dołączane do wyjścia strony lub przechowywane w dzienniku śledzenia w aplikacji. Można użyć programu ASP.Przeglądarka netto śledzenia (Trace.axd) do wyświetlania zawartości dziennika śledzenia. Domyślnie, przeglądanie elementu Trace.axd dodaje się do httpHandlers element.
Uwaga
Ogólnie nie należy włączać śledzenia w aktywnej witrynie sieci Web, ponieważ to wyświetlenie konfiguracji poufnych informacji dla każdego, kto wyświetleń strony w witrynie sieci Web.Śledzenie przeznaczone wyłącznie do celów debugowania.Jeśli localOnly atrybut jest true, informacje śledzenia są wyświetlane tylko dla żądań localhost.Ponadto jeśli <deployment retail=true> jest ustawiony w pliku Web.config, śledzenie jest wyłączone.
Można użyć właściwości i metod w Trace tworzy klasę do wydania dokumentu. Oprzyrządowanie umożliwia monitorowanie zdrowia aplikacji uruchamiając aplikację w rzeczywistych ustawień. Śledzenie pomaga izolowanie problemów i rozwiązują problemy bez zakłócania pracy działającego systemu.
W celu śledzenia, które zostały wprowadzone należy ponownie skompilować aplikację z ustawioną flagą śledzenia. Można to zrobić przez ustawienie compilerOptions atrybut = "/ d:TRACE" w wierszu konfiguracji dla kompilatora języka mają obsługiwać śledzenie. Odnoszą się do<compiler> Element
Domyślna konfiguracja
Następujące domyślne trace element nie jest jawnie skonfigurowane w pliku Machine.config lub głównego pliku Web.config. Jednakże jest domyślnej konfiguracji, który jest zwracany przez aplikację w.NET Framework 2.0 i nowsze wersje.
<trace
enabled="false"
localOnly="true"
mostRecent="false"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
writeToDiagnosticsTrace="false"
/>
Następujące domyślne trace element jest skonfigurowany w pliku Machine.config w.NET Framework w wersji 1.0 i 1.1.
<trace
enabled="false"
localOnly="true"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
/>
Przykład
Poniższy przykład kodu demonstruje, jak określić ustawienia konfiguracji śledzenia.
<configuration>
<system.web>
<trace enabled="true"
pageOutput="true"
requestLimit="15"
mostRecent="true" />
<system.web>
</configuration>
Informacje o elementach
Program obsługi sekcji konfiguracji |
|
Członkowskie konfiguracji |
|
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 nowszej wersji. .NET Framework Microsoft Visual Studio |
Zobacz też
Zadania
How to: View Trace Information with the Trace Viewer
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Informacje
System.Web elementu (ASP.Schemat ustawień netto)
Konfiguracja elementu (schemat ustawień ogólne)
Koncepcje
ASP.NET Configuration File Hierarchy
Inne zasoby
Ogólne ustawienia konfiguracji (ASP.(NET)
ASP.NET ustawienia konfiguracji