trace Ögesi (ASP.NET Ayarlar Şeması)
İzleme sonuçlarının toplanması, depolanması ve görüntülenmesini denetleyen ASP.NET kod izleme hizmetini yapılandırır.
<trace
enabled="true|false"
localOnly="true|false"
pageOutput="true|false"
requestLimit="integer"
mostRecent="true|false"
writeToDiagnosticsTrace="true|false"
traceMode="SortByTime|SortByCategory"
/>
Öznitelikler ve Öğeler
Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.
Öznitelikler
Öznitelik |
Açıklama |
|---|---|
enabled |
İsteğe bağlı Boolean özniteliği. Bir uygulama için izleme özelliğinin etkin olup olmadığını belirtir. Trace.axd görüntüleyicisini kullanabilmek için izleme özelliği etkin olmalıdır. Varsayılan olarak, Trace.axd görüntüleyicisi httpHandlers ögesine eklenir. Varsayılan, false değeridir. |
localOnly |
İsteğe bağlı Boolean özniteliği. İzleme görüntüleyicisinin (Trace.axd) yalnızca konak Web sunucusunda kullanılabilir olup olmadığını belirtir. false ise, izleme görüntüleyicisinin her bilgisayardan kullanılabileceğini belirtir. Varsayılan olarak, Trace.axd görüntüleyicisi httpHandlers ögesine eklenir. Varsayılan, true değeridir. |
mostRecent |
İsteğe bağlı Boolean özniteliği. En son uygulama düzeyinde izleme çıkışının görüntülenip görüntülenmediğini ve requestLimit tarafından belirtilen sınırları aşan eski izleme verilerinin atılıp atılmadığını belirtir. false ise, requestLimit özniteliğine ulaşılana kadar istekler için izleme verileri görüntülenir. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan, false değeridir. |
pageOutput |
İsteğe bağlı Boolean özniteliği. Her sayfanın sonunda izleme çıktısı oluşturulup oluşturulmayacağını belirtir. false ise, izleme çıkışına yalnızca izleme yardımcı programıyla erişilir. Varsayılan, false değeridir. |
requestLimit |
İsteğe bağlı Int32 özniteliği. Sunucuda depolanacak izleme isteği sayısını belirtir. Eğer sınıra ulaşılırsa ve mostRecent özniteliği false ise, izleme özelliği otomatik olarak devre dışı bırakılır. En çok istek sınırı 10.000'dir. 10.000'den daha büyük bir değer belirtilirse, değeri sessizce ASP.NET tarafından 10.000'e yuvarlanır. Varsayılan, 10 değeridir. |
traceMode |
İsteğe bağlı TraceDisplayMode özniteliği. İzleme bilgilerini görüntülemek istediğiniz sırayı belirtir. traceMode özniteliği aşağıdaki değerlerden herhangi biri olabilir.
ValueAçıklama
SortByCategory İzleme bilgilerinin kullanıcı tanımlı kategoriler biçiminde alfabetik olarak görüntüleneceğini belirtir.
SortByTime İzleme bilgilerinin izleme bilgileri işleme sırasıyla görüntüleneceğini belirtir.
Varsayılan, SortByTime değeridir. |
writeToDiagnosticsTrace |
İsteğe bağlı Boolean özniteliği. ASP.NET izleme iletilerinin Trace iletilerini görüntülemek amacıyla kayıtlı olan tüm dinleyiciler için System.Diagnostics izleme altyapısına iletilip iletilmediğini belirtir. Daha fazla bilgi için bkz. system.diagnostics'in izleme ögesi. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. false varsayılan değerdir. |
Alt Öğeler
Yok.
Üst Öğeler
Öge |
Açyklama |
|---|---|
configuration |
Ortak dil çalıştırma modülü ile .NET Framework uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir. |
system.web |
Yapılandırma dosyasında ASP.NET yapılandırma ayarları için kök öge belirtir ve ASP.NET Web uygulamalarını yapılandıran ve uygulamaların davranışını denetleyen yapılandırma ögelerini içerir. |
Açıklamalar
İzleme etkinleştirildiğinde, her sayfa isteği sayfa çıkışına eklenebilen veya uygulama izleme günlüğüne kaydedilebilen izleme iletileri oluşturur. İzleme günlüğünün içeriğini görüntülemek için ASP.NET izleme görüntüleyicisini (Trace.axd) kullanın. Varsayılan olarak, Trace.axd görüntüleyicisi httpHandlers ögesine eklenir.
.gif "Not") Not |
|---|
Genellikle, etkin bir Web sitesinde izlemeyi etkinleştirmemeniz gerekir, çünkü bu, Web sitedeki sayfaları görüntüleyen herhangi birine önemli yapılandırma bilgileri görüntüleyebilir.İzleme, yalnızca hata ayıklama amacına yöneliktir.localOnly özniteliği true ise, izleme bilgileri yalnızca ana makine istekleri için görüntülenir.Ayrıca, Web.config dosyasında <deployment retail=true> olarak ayarlanırsa izleme devre dışı bırakılır. |
Sürüm yapılarını işaretlemek için Trace sınıfındaki özellikleri ve yöntemleri kullanabilirsiniz. Araçlar, gerçek yaşam ayarlarındaki uygulamayı çalıştırarak uygulama durumu denetimi yapmanızı sağlar. İzleme, sorunları yalıtmanıza ve çalışan sistemi bozmadan sorunları gidermenize yardımcı olur.
İzlemenin etkili olmasını sağlamak için, izleme bayrağını ayarlayarak uygulamanızı yeniden derlemeniz gerekir. Bunu, izlemeyi desteklemek istediğiniz dil derleyicisi için yapılandırma satırında compilerOptions özniteliğini = "/ d:TRACE"e ayarlayarak yapın. <compiler> Element bölümüne başvurabilirsiniz.
Varsayılan Yapılandırma
Aşağıdaki varsayılan trace ögesi Machine.config dosyası veya kök Web.config dosyasında tam olarak yapılandırılmamıştır. Ancak bu, .NET Framework 2.0 ve sonraki sürümlerinde uygulama tarafından döndürülen varsayılan yapılandırmadır.
<trace
enabled="false"
localOnly="true"
mostRecent="false"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
writeToDiagnosticsTrace="false"
/>
.NET Framework sürüm 1.0 ve 1.1'de, aşağıdaki varsayılan trace ögesi Machine.config dosyası içinde yapılandırılmıştır.
<trace
enabled="false"
localOnly="true"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
/>
Örnek
Aşağıdaki kod örneğinde, izleme yapılandırma ayarlarının nasıl belirtileceği gösterilmiştir.
<configuration>
<system.web>
<trace enabled="true"
pageOutput="true"
requestLimit="15"
mostRecent="true" />
<system.web>
</configuration>
Öğe Bilgileri
Yapılandırma bölümü işleyicisi |
|
Yapılandırma üyesi |
|
Yapılandırılabilir konumlar |
Machine.config Kök düzeyinde Web.config Uygulama düzeyinde Web.config Sanal veya fiziksel dizin düzeyinde Web.config |
Gereksinimler |
Microsoft Internet Information Services (IIS) 5.0 ve sonraki sürümleri .NET Framework Microsoft Visual Studio |
Ayrıca bkz.
Görevler
Nasıl Yapılır: İzleme görüntüleyicisinin ile ASP.NET İzleme Bilgileri görüntüleme
Nasıl Yapılır: Özel dizin Yer Ayarlar kullanarak yapılandırma
Nasıl Yapılır: ASP.NET Yapılandırması kilitlemek Ayarlar
Başvuru
system.web Ögesi (ASP.NET Ayarlar Şeması)
configuration Ögesi (Genel Ayarlar Şeması)
Kavramlar
ASP.NET Yapılandırması dosyası hiyerarşi ve Kalıtım
ASP.NET Yapılandırması güvenliğini sağlama
ASP.NET Yapılandırması senaryoları
Diğer Kaynaklar
Genel Yapılandırma Ayarları (ASP.NET)