Aracılığıyla paylaş


Adım Adım Kılavuz: Özel Kayıt Dinleyicileri Oluşturma (Visual Basic)

Bu kılavuz, özel bir günlük dinleyicisi oluşturmayı ve bu dinleyiciyi My.Application.Log nesnesinin çıkışını dinleyecek şekilde yapılandırmayı gösterir.

Başlangıç Yapmak

Günlük dinleyicileri TraceListener sınıfından türetmelidir.

Dinleyiciyi oluşturmak için

  • Uygulamanızda, SimpleListener öğesinden devralan TraceListener adlı bir sınıf oluşturun.

    Public Class SimpleListener
        Inherits System.Diagnostics.TraceListener
    
        <Security.Permissions.HostProtection(Synchronization:=True)>
        Public Overloads Overrides Sub Write(ByVal message As String)
            MsgBox("Write: " & message)
        End Sub
    
        <Security.Permissions.HostProtection(Synchronization:=True)>
        Public Overloads Overrides Sub WriteLine(ByVal message As String)
            MsgBox("WriteLine: " & message)
        End Sub
    End Class
    

    Write ve WriteLine yöntemleri, temel sınıf tarafından talep edilen, girişlerini görüntülemek için MsgBox çağırır.

    HostProtectionAttribute özelliği, temel sınıf yöntemleriyle uyumlu olması için Write ve WriteLine yöntemlerine uygulanır. Bu öznitelik, HostProtectionAttribute kodunu çalıştıran konağın kodun konak koruma eşitlemesini açığa çıkardığını belirlemesini sağlar.

    Uyarı

    HostProtectionAttribute özniteliği yalnızca ortak dil çalışma zamanını barındıran ve SQL Server gibi konak koruması uygulayan yönetilmeyen uygulamalarda etkilidir.

My.Application.Log bileşeni sizin günlük dinleyicinizi kullansın diye, günlük dinleyicinizi içeren derlemeyi özel adla tanımlamalısınız.

Bir sonraki prosedür, güçlü bir şekilde adlandırılmış bir kayıt dinleyicisi derlemesi oluşturmak için basit adımlar sağlar. Daha fazla bilgi için bkz Güçlü Adlandırılmış Derlemeler Oluşturma ve Kullanma.

Günlük dinleyicisi derlemesine güçlü ad vermek için

  1. Çözüm Gezgini'nde bir projenin seçilmesini sağlayın. Proje menüsünde Özellikler'i seçin.

  2. İmzalama sekmesine tıklayın.

  3. Derlemeyi imzala kutusunu seçin.

  4. <Yeni> seçeneğini Tanımlayıcı ad anahtarı dosyası seçin açılır listesinden seçin.

    Tanımlayıcı Ad Anahtarı Oluştur iletişim kutusu açılır.

  5. Anahtar dosyası adı kutusuna anahtar dosyası için bir ad girin.

  6. Parola Gir ve Parolayı Onayla kutularına bir parola girin.

  7. Tamam'a tıklayın.

  8. Uygulamayı yeniden oluşturun.

Dinleyici ekleme

Derlemenin tanımlayıcı bir adı olduğuna göre, My.Application.Log günlük dinleyicisini kullanması için dinleyicinin tanımlayıcı adını belirlemeniz gerekir.

Kesin olarak adlandırılmış bir türün biçimi aşağıdaki gibidir.

<tür adı>, <derleme adı>, <sürüm numarası>, <kültür>, <tanımlayıcı ad>

Dinleyicinin kesin adını belirlemek için

  • Aşağıdaki kod, SimpleListener için güçlü adlandırılmış tür adının nasıl belirleneceğini gösterir.

    Public Sub DisplaySimpleListenerStrongName()
        Dim t As Type = GetType(SimpleListener)
        MsgBox(t.FullName & ", " & t.Assembly.FullName)
    End Sub
    

    Türün kesin adı projenize bağlıdır.

Güçlü ad ile dinleyiciyi My.Application.Log günlük dinleyici koleksiyonuna ekleyebilirsiniz.

Dinleyiciyi My.Application.Log dosyasına eklemek için

  1. Çözüm Gezgini'nde app.config sağ tıklayın ve Aç'ı seçin.

    -veya-

    bir app.config dosyası varsa:

    1. Proje menüsünde Yeni Öğe Ekle'yi seçin.

    2. Yeni Öğe Ekle iletişim kutusunda Uygulama Yapılandırma Dosyası'nı seçin.

    3. Ekle'yi tıklatın.

  2. <listeners> bölümünde, <source> bölümünde bulunan, "DefaultSource" özniteliğine sahip name bölümünü <sources> bölümünde bulun. <sources> bölümü, <system.diagnostics> bölümünde, en üst düzey <configuration> bölümünde yer alır.

  3. Bu öğeyi <listeners> bölümüne ekleyin:

    <add name="SimpleLog" />
    
  4. <sharedListeners> En üst düzey <system.diagnostics> bölümdeki <configuration> bölümünü bulun.

  5. Bu öğeyi bu <sharedListeners> bölüme ekleyin:

    <add name="SimpleLog" type="SimpleLogStrongName" />
    

    değerini SimpleLogStrongName dinleyicinin tanımlayıcı adı olacak şekilde değiştirin.

Ayrıca bakınız