FileLogTraceListener Sınıf

Tanım

Ad Alanı:

Microsoft.VisualBasic.Logging

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Forms.dll

Günlüğe kaydetme çı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ş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

FileLogTraceListener()	Sınıfının yeni bir örneğini FileLogTraceListener 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

Append	Çıktının geçerli dosyaya eklenip eklenmeyeceğini veya yeni veya var olan bir dosyaya yazılıp yazılmayacağını belirler.
Attributes	Uygulama yapılandırma dosyasında tanımlanan özel izleme dinleyicisi özniteliklerini alır. (Devralındığı yer: TraceListener)
AutoFlush	Günlük dosyası akışına yazma işleminin arabelleği boşaltıp boşaltmadığını 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 Customgünlük dosyası dizinini Location 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 yapılması gerekenleri 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.
Filter	İzleme dinleyicisi için izleme filtresini alır veya ayarlar. (Devralındığı yer: TraceListener)
FullLogFileName	Geçerli tam günlük dosyası adını alır.
IncludeHostName	Günlüğe kaydetme makinesinin ana bilgisayar adının çıkışa eklenip eklenmeyeceğini gösterir.
IndentLevel	Girinti düzeyini alır veya ayarlar. (Devralındığı yer: TraceListener)
IndentSize	Girintideki boşlukların sayısını alır veya ayarlar. (Devralındığı yer: TraceListener)
IsThreadSafe	İzleme dinleyicisinin iş parçacığı güvenli olup olmadığını belirten bir değer alır. (Devralındığı yer: TraceListener)
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.
Name	Bu TraceListeneriçin bir ad alır veya ayarlar. (Devralındığı yer: TraceListener)
NeedIndent	Çıkışı girintileyip girintilemeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: TraceListener)
ReserveDiskSpace	İletilerin günlük dosyasına yazılabilmesi için gereken boş disk alanı miktarını bayt cinsinden alır veya ayarlar.
TraceOutputOptions	İzleme çıkışı seçeneklerini alır veya ayarlar. (Devralındığı yer: TraceListener)

Yöntemler

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.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	TraceListener tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: TraceListener)
Dispose(Boolean)	Temel alınan akışı kapatır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Fail(String)	sınıfını uygularken oluşturduğunuz dinleyiciye bir hata iletisi yayar TraceListener . (Devralındığı yer: TraceListener)
Fail(String, String)	Sınıfını uygularken oluşturduğunuz dinleyiciye bir hata iletisi ve ayrıntılı bir hata iletisi yayar TraceListener . (Devralındığı yer: TraceListener)
Flush()	Geçerli günlük dosyasına yazan temel akışı temizler.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetSupportedAttributes()	İzleme dinleyicisi tarafından desteklenen özel XML yapılandırma özniteliklerini alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Çıkış dosyasına veya akışa izleme bilgilerini, veri nesnesini ve olay bilgilerini yazar.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Çıkış dosyasına veya akışa izleme bilgilerini, bir veri nesneleri dizisini ve olay bilgilerini yazar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	dinleyiciye özgü çıkışa izleme ve olay bilgileri yazar. (Devralındığı yer: TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	İzleme bilgilerini, bir iletiyi ve olay bilgilerini çıkış dosyasına veya akışa 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.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	İzleme bilgilerini, bir iletiyi, ilgili etkinlik kimliğini ve olay bilgilerini dinleyiciye özel çıktıya yazar. (Devralındığı yer: TraceListener)
Write(Object)	nesnesinin ToString() yönteminin değerini sınıfını uygularken oluşturduğunuz dinleyiciye TraceListener yazar. (Devralındığı yer: TraceListener)
Write(Object, String)	Sınıfını uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesnenin ToString() yönteminin TraceListener değerini yazar. (Devralındığı yer: TraceListener)
Write(String)	Ek bağlam bilgisi olmadan diske ayrıntılı bir ileti yazar.
Write(String, String)	Sınıfını uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti yazar. (Devralındığı yer: TraceListener)
WriteIndent()	Bu sınıfı uygularken oluşturduğunuz dinleyiciye girintiyi yazar ve özelliğini olarak falsesıfırlarNeedIndent. (Devralındığı yer: TraceListener)
WriteLine(Object)	nesnesinin ToString() yönteminin değerini sınıfını uygularken oluşturduğunuz dinleyiciye TraceListener yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TraceListener)
WriteLine(Object, String)	Sınıfını uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesnenin ToString() yönteminin TraceListener değerini yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TraceListener)
WriteLine(String)	Ek bağlam bilgisi olmadan diske ayrıntılı bir ileti yazar ve ardından geçerli satır sonlandırıcısını yazar.
WriteLine(String, String)	Sınıfı uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TraceListener)

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