FileLogTraceListener Sınıf

Tanım

Ad Alanı:

Microsoft.VisualBasic.Logging

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Forms.dll

Kaynak:

FileLogTraceListener.vb

Günlük çıkışını dosyaya yönlendiren basit bir dinleyici sağlar.

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şiv işlevi, geliştiricilerin ve yöneticilerin bakım sorumluluklarını azaltmaya yardımcı olur.

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

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

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

   Dosya adının açık biçimi [-][-baseNamedateStamp].log, versionburada:

   • 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 LogFileCreationScheduleolduğunda DailyWeekly 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, kilit kullanmadan birden çok iş parçacığından gelen iletileri güvenli bir şekilde günlüğe yazmanızı sağlar.

Log-File 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 .

Log-File 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 DailyolduğundaWeekly, 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ğe bağlı DiskSpaceExhaustedBehavior 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ı kullanmamasını sağlamaya yardımcı olur. DiskSpaceExhaustedBehavior Bayttan ReserveDiskSpace az boş olduğunda günlük yazma davranışını belirtmek için özelliğini kullanın.

Çıkış AyarlarınıLog-File

• özelliği, AutoFlush günlük dosyasına yapılan her yazmadan sonra temel alınan akışın otomatik olarak boşaltılıp boşaltılmayacağını belirtir.
• Append özelliği, izin verilirse 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.
• özelliği, Delimiter günlük iletisindeki alanları sınırlandırmak için kullanılacak dizeyi belirtir.
• özelliği, Encoding yeni bir günlük dosyası oluştururken kullanılacak kodlamayı belirtir.

çıktıyıLog-File

• TraceData ve TraceEvent yöntemleri günlük dosyasına ileti yazar. Bu yöntemler, yeni bir günlük oluşturulması gerekip gerekmediğini belirlemek için özelliği ve aynı temel ada sahip mevcut günlükleri denetler LogFileCreationSchedule .
• yöntemi, Flush şu anda çıkış arabelleğindeki tüm iletileri günlük dosyasına boşaltır.
• yöntemi, Close 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, derleyici komut satırına bayrağını ekleyin /d:DEBUG=True .
• C# dilinde izlemeyi etkinleştirmek için, /d:TRACE kodunuzu derlerken derleyici komut satırına bayrağını ekleyin veya dosyanızın en üstüne ekleyin #define TRACE . Visual Basic'te, derleyici komut satırına bayrağını ekleyin /d:TRACE=True .

.NET Framework uygulamalarında, uygulamanız için yapılandırma dosyasını düzenleyerek dinleyicinizin düzeyini ayarlayabilirsiniz. Bu dosyanın içinde bir dinleyici ekleyebilir, türünü ayarlayabilir ve parametrelerini ayarlayabilir, bir 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

Name	Description
FileLogTraceListener()	Sınıfın FileLogTraceListener yeni bir örneğini varsayılan adla başlatır.
FileLogTraceListener(String)	Sağlanan adla sınıfının yeni bir örneğini FileLogTraceListener başlatır.

Özellikler

Name	Description
Append	Çıktının geçerli dosyaya eklenip eklenmeyeceğini veya yeni veya var olan bir dosyaya yazılıp yazılmayacağını belirler.
AutoFlush	Günlük dosyası akışına yazılanların arabelleği temizleyip temizlemediğini gösterir.
BaseFileName	Tam günlük dosyası adını oluşturmak için kullanılan günlük dosyalarının temel adını alır veya ayarlar.
CustomLocation	özelliği olarak ayarlandığında Locationgünlük dosyası dizinini Custom alır veya ayarlar.
Delimiter	Günlük iletisindeki alanları sınırlandırmak için kullanılan sınırlayıcıyı alır veya ayarlar.
DiskSpaceExhaustedBehavior	Günlük dosyasına yazarken ne yapacağını belirler ve özelliği tarafından ReserveDiskSpace belirtilenden daha az boş disk alanı vardır.
Encoding	Yeni bir günlük dosyası oluştururken kullanılacak kodlamayı alır veya ayarlar.
FullLogFileName	Geçerli tam günlük dosyası adını alır.
IncludeHostName	Günlüğe kaydetme makinesinin ana bilgisayar adının çıktıya eklenip eklenmeyeceğini gösterir.
Location	Günlük dosyalarının konumunu alır veya ayarlar.
LogFileCreationSchedule	Günlük dosyalarının adlarına hangi tarihin ekleneceğini belirler.
MaxFileSize	Günlük dosyasının izin verilen en büyük boyutunu bayt cinsinden alır veya ayarlar.
ReserveDiskSpace	İletilerin günlük dosyasına yazılabilmesi için gereken boş disk alanı miktarını bayt cinsinden alır veya ayarlar.

Yöntemler

Name	Description
Close()	Geçerli günlük dosyası için temel alınan akışı kapatır ve geçerli akışla ilişkili tüm kaynakları serbest bırakır.
Dispose(Boolean)	Temel alınan akışı kapatır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
Flush()	Geçerli günlük dosyasına yazan temel akışı temizler.
GetSupportedAttributes()	İzleme dinleyicisi tarafından desteklenen özel XML yapılandırma özniteliklerini alır.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Çıkış dosyasına veya akışına izleme bilgilerini, veri nesnesini ve olay bilgilerini yazar.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Çıkış dosyasına veya akışa izleme bilgileri, veri nesneleri dizisi ve olay bilgileri yazar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Çıkış dosyasına veya akışa izleme bilgilerini, biçimlendirilmiş bir nesne dizisini ve olay bilgilerini yazar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Çıkış dosyasına veya akışa izleme bilgileri, ileti ve olay bilgileri yazar.
Write(String)	Ek bağlam bilgisi olmadan diske ayrıntılı bir ileti yazar.
WriteLine(String)	Ek bağlam bilgisi olmadan diske bir ayrıntılı ileti yazar ve ardından geçerli satır sonlandırıcısını yazar.

Ayrıca bkz.

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