FileLogTraceListener Sınıf

Tanım

public ref class FileLogTraceListener : System::Diagnostics::TraceListener

[System.Runtime.InteropServices.ComVisible(false)]
public class FileLogTraceListener : System.Diagnostics.TraceListener

[<System.Runtime.InteropServices.ComVisible(false)>]
type FileLogTraceListener = class
    inherit TraceListener

Public Class FileLogTraceListener
Inherits TraceListener

Devralma

Object

MarshalByRefObject

TraceListener

FileLogTraceListener

Öznitelikler

ComVisibleAttribute

Açıklamalar

FileLogTraceListener sınıfı günlük dosyalarını gerektiğinde günlük veya uygulama başına arşivlerken otomatik bakım özellikleri sağlar. Bu otomatik arşivleme işlevi, geliştiricilerin ve yöneticilerin bakım sorumluluklarını azaltmaya yardımcı olur.

Günlük kaydından gelen çıkışı bir metin dosyasına yeniden yönlendirmek için veya Trace.Listeners koleksiyonlarına bir örneği FileLogTraceListener eklenebilirDebug.Listeners. Bu sınıfın örnekleri, Visual Basic uygulamalarında veya My.Log (Web uygulamaları için) için de eklenebilirMy.Application.Log. Daha fazla bilgi için bkz. İzlenecek Yol: My.Application.Log'un Bilgileri Yazdığı Yeri Değiştirme.

Bu sınıfın ana özellikleri şunlardır:

1. Arşiv işlevselliği. Bu sınıf tarafından oluşturulan günlük dosyaları, günlük dosyasını günlüğün ardışık sürümlerinden ayırt etmek için bir sayının yanı sıra temel ada ve tarihe göre adlandırılır. Yeni günlük dosyaları gerektiğinde oluşturulur.

   Dosya adının baseNameaçık biçimi [-][-dateStampversion].log, burada:

   • baseName bölümü, özelliği tarafından belirtilen temel günlük adıdırBaseFileName.

   • Bölümün dateStamp "YYYY-AA-GG" biçimi vardır ve veya Weeklyolduğunda LogFileCreationScheduleDaily gösterilir.

   • aynı baseName ve dateStampile birden fazla günlük dosyası gerekiyorsa, version dosya adına pozitif Integerbir bölüm eklenir.

2. Birden çok sınıf örneği. Sınıfın FileLogTraceListener bir örneği kullanımda olan bir dosyaya yazarsa:

   • sınıfı, aynı işlemde sınıfın başka bir örneği FileLogTraceListener tarafından kullanılıyorsa dosyayı paylaşır.

   • sınıfı, dosya başka bir işlem tarafından kullanılıyorsa, sonraki kullanılabilir adı kullanarak yeni bir günlük dosyası oluşturur.

3. İş parçacığı güvenliği. FileLogTraceListener sınıfı iş parçacığı güvenlidir. Bu sayede kilit kullanmadan birden çok iş parçacığından gelen iletileri günlüğe güvenle yazabilirsiniz.

Günlük Dosyası Konumu

• özelliği, Location günlük dosyasının yazılacak tipik dizinlerden birini belirtmek için bir LogFileLocation numaralandırma alır.

• Günlüğü başka bir konuma yazmak için özelliğini bu konuma ayarlayın CustomLocation .

Günlük Dosyası Adı

• Günlük dosyasının temel adı özelliği tarafından BaseFileName belirtilir.

• Geçerli günlük dosyası adı özelliğinden FullLogFileName okunabilir. Diğer birkaç özellikten ve dosya sistemindeki günlüklerin geçerli durumundan türetilir.

Günlük Bakımı

• Yeni günlük dosyaları oluşturmak için en düşük sıklık özelliği tarafından LogFileCreationSchedule belirlenir. değer veya WeeklyolduğundaDaily, her gün veya haftada en az bir kez yeni bir günlük dosyası oluşturulur ve ada bir tarih damgası eklenirFullLogFileName.

• Günlük dosyasının en büyük boyutu (bayt cinsinden) özelliği tarafından MaxFileSize belirlenir. Günlük dosyası boyutu bu boyutu aşarsa, günlüğe yazılan ek iletiler atılır ve özelliğine DiskSpaceExhaustedBehavior bağlı olarak bir özel durum oluşturulur.

• ReserveDiskSpace özelliği, ne kadar boş alan (bayt cinsinden) olması gerektiğini belirler. Bu, sınıfın FileLogTraceListener tüm kullanılabilir disk alanını tüketmemesini sağlamaya yardımcı olur. DiskSpaceExhaustedBehavior Boş bayttan ReserveDiskSpace az olduğunda günlük yazma davranışını belirtmek için özelliğini kullanın.

Günlük Dosyası Çıkış Ayarları

• AutoFlush özelliği, günlük dosyasına her yazıldıktan sonra temel alınan akışın otomatik olarak boşaltılıp boşaltılmayacağını belirtir.

• Append özelliği, izin veriliyorsa iletilerin geçerli günlük dosyasına eklenip eklenmeyeceğini veya yeni bir günlük dosyasına yazılıp yazılmayacağını belirtir.

• Delimiter özelliği, günlük iletisindeki alanları sınırlandırmak için kullanılacak dizeyi belirtir.

• Encoding özelliği, yeni bir günlük dosyası oluştururken kullanılacak kodlamayı belirtir.

Günlük Dosyası Çıkışı

• TraceData ve TraceEvent yöntemleri günlük dosyasına ileti yazar. Bu yöntemler, yeni bir günlük oluşturulup oluşturulmaması gerektiğini belirlemek için aynı temel ada sahip mevcut günlüklerle birlikte özelliğini denetler LogFileCreationSchedule .

• yöntemi, Flush şu anda çıkış arabelleğindeki tüm iletileri günlük dosyasına boşaltır.

• Close yöntemi, diğer işlemler tarafından kullanılabilmesi için günlük dosyasını kapatır.

Çıktıyı Etkinleştirme

İzleme dinleyicisi kullanmak için izlemeyi veya hata ayıklamayı etkinleştirmeniz gerekir. Aşağıdaki söz dizimi derleyiciye özgüdür. C# veya Visual Basic dışında derleyiciler kullanıyorsanız, derleyicinizin belgelerine bakın.

• C# dilinde hata ayıklamayı etkinleştirmek için, /d:DEBUG kodunuzu derlerken derleyici komut satırına bayrağını ekleyin veya dosyanızın en üstüne ekleyebilirsiniz #define DEBUG . Visual Basic'te bayrağını /d:DEBUG=True derleyici komut satırına ekleyin.

• C# dilinde izlemeyi etkinleştirmek için kodunuzu /d:TRACE derlerken derleyici komut satırına bayrağını ekleyin veya dosyanızın en üstüne ekleyin #define TRACE . Visual Basic'te bayrağını /d:TRACE=True derleyici komut satırına ekleyin.

.NET Framework uygulamalarda, uygulamanızın yapılandırma dosyasını düzenleyerek dinleyicinizin düzeyini ayarlayabilirsiniz. Bu dosyanın içine bir dinleyici ekleyebilir, türünü ayarlayabilir ve parametrelerini ayarlayabilir, dinleyiciyi kaldırabilir veya uygulama tarafından daha önce ayarlanan tüm dinleyicileri temizleyebilirsiniz. Yapılandırma dosyası aşağıdaki örnekte olduğu gibi biçimlendirilmelidir.

<configuration>  
    <system.diagnostics>  
        <sharedListeners>  
            <add name="FileLog"  
                type="Microsoft.VisualBasic.Logging.FileLogTraceListener,   
                      Microsoft.VisualBasic, Version=8.0.0.0,   
                      Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a,   
                      processorArchitecture=MSIL"   
                initializeData="FileLogWriter"/>  
        </sharedListeners>  
    </system.diagnostics>  
</configuration>  

Bu örneğin çalışması için tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• BaseFileName
• TraceData(TraceEventCache, String, TraceEventType, Int32, Object)
• TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)
• Flush()
• Close()
• İzlenecek yol: My.Application.Log Günlüğünün Bilgileri Yazdığı Yeri Değiştirme