Log.WriteEntry Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.Logging

Sestavení:

Microsoft.VisualBasic.Forms.dll

Zapíše zprávu do naslouchacích procesů protokolu aplikace.

Přetížení

Name	Description
WriteEntry(String)	Zapíše zprávu do naslouchacích procesů protokolu aplikace.
WriteEntry(String, TraceEventType)	Zapíše zprávu do naslouchacích procesů protokolu aplikace.
WriteEntry(String, TraceEventType, Int32)	Zapíše zprávu do naslouchacích procesů protokolu aplikace.

WriteEntry(String)

Zdroj:

Log.vb

Zapíše zprávu do naslouchacích procesů protokolu aplikace.

public:
 void WriteEntry(System::String ^ message);

public void WriteEntry(string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parametry

message

String

Required. Zpráva, která se má protokolovat. Pokud message ano Nothing, použije se prázdný řetězec.

Výjimky

SecurityException

Kód s částečnou důvěryhodností volá metodu, ale zapisuje do naslouchacího procesu protokolu událostí, který vyžaduje úplný vztah důvěryhodnosti.

Příklady

Tento příklad ukazuje, jak použít metodu My.Application.Log.WriteEntry k protokolování informací o trasování. Další informace naleznete v tématu Postupy: Zápis zpráv protokolu.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Tento příklad kódu se může spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteEntry nastavení My.Log.WriteEntry webových aplikací.

Poznámky

Metoda WriteEntry zapíše zprávu do naslouchacích procesů protokolu událostí aplikace.

V klientských aplikacích Log je objekt dostupný prostřednictvím objektu My.Application.Log . Ve webových aplikacích Log je objekt dostupný prostřednictvím objektu My.Log .

Informace o tom, které naslouchací procesy protokolu přijímají WriteEntry zprávy metody, najdete v části Návod: Určení, kde My.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolu můžete změnit. Další informace naleznete v tématu Práce s protokoly aplikací.

Pro přetížení, které nepřebírají id argument, je zapsáno id do protokolu definováno v následující tabulce.

severity	Výchozí id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

Následující tabulka uvádí příklady úkolů zahrnujících metodu WriteEntry .

To	Podívejte se
Zápis informací o událostech do naslouchacích procesů protokolu aplikace	Postupy: Zápis zpráv protokolu
Určení, kde Log se zapisují informace	Návod: Určení, kde my.application.log zapisuje informace

Dostupnost podle typu projektu

Typ projektu	Available
Aplikace pro systém Windows	Yes
Knihovna tříd	Yes
Konzolová aplikace	Yes
Knihovna ovládacích prvků systému Windows	Yes
Knihovna webových ovládacích prvků	No
Služba systému Windows	Yes
Web	Yes

Viz také

• TraceEventType
• Objekty (Visual Basic)
• Working with Application Logs in Visual Basic
• Postupy: Zápis zpráv protokolu
• Návod: Určení, kde my.application.log zapisuje informace

WriteEntry(String, TraceEventType)

Zdroj:

Log.vb

Zapíše zprávu do naslouchacích procesů protokolu aplikace.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity);

public void WriteEntry(string message, System.Diagnostics.TraceEventType severity);

member this.WriteEntry : string * System.Diagnostics.TraceEventType -> unit

Public Sub WriteEntry (message As String, severity As TraceEventType)

Parametry

message

String

Required. Zpráva, která se má protokolovat. Pokud message ano Nothing, použije se prázdný řetězec.

severity

TraceEventType

Typ zprávy. Ve výchozím nastavení TraceEventType.Information.

Výjimky

InvalidEnumArgumentException

Typ zprávy není jednou z hodnot výčtu TraceEventType .

SecurityException

Kód s částečnou důvěryhodností volá metodu, ale zapisuje do naslouchacího procesu protokolu událostí, který vyžaduje úplný vztah důvěryhodnosti.

Příklady

Tento příklad ukazuje, jak použít metodu My.Application.Log.WriteEntry k protokolování informací o trasování. Další informace naleznete v tématu Postupy: Zápis zpráv protokolu.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Tento příklad kódu se může spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteEntry nastavení My.Log.WriteEntry webových aplikací.

Poznámky

Metoda WriteEntry zapíše zprávu do naslouchacích procesů protokolu událostí aplikace.

V klientských aplikacích Log je objekt dostupný prostřednictvím objektu My.Application.Log . Ve webových aplikacích Log je objekt dostupný prostřednictvím objektu My.Log .

Informace o tom, které naslouchací procesy protokolu přijímají WriteEntry zprávy metody, najdete v části Návod: Určení, kde My.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolu můžete změnit. Další informace naleznete v tématu Práce s protokoly aplikací.

Pro přetížení, které nepřebírají id argument, je zapsáno id do protokolu definováno v následující tabulce.

severity	Výchozí id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

Následující tabulka uvádí příklady úkolů zahrnujících metodu WriteEntry .

To	Podívejte se
Zápis informací o událostech do naslouchacích procesů protokolu aplikace	Postupy: Zápis zpráv protokolu
Určení, kde Log se zapisují informace	Návod: Určení, kde my.application.log zapisuje informace

Dostupnost podle typu projektu

Typ projektu	Available
Aplikace pro systém Windows	Yes
Knihovna tříd	Yes
Konzolová aplikace	Yes
Knihovna ovládacích prvků systému Windows	Yes
Knihovna webových ovládacích prvků	No
Služba systému Windows	Yes
Web	Yes

Viz také

• TraceEventType
• Objekty (Visual Basic)
• Working with Application Logs in Visual Basic
• Postupy: Zápis zpráv protokolu
• Návod: Určení, kde my.application.log zapisuje informace

WriteEntry(String, TraceEventType, Int32)

Zdroj:

Log.vb

Zapíše zprávu do naslouchacích procesů protokolu aplikace.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity, int id);

public void WriteEntry(string message, System.Diagnostics.TraceEventType severity, int id);

member this.WriteEntry : string * System.Diagnostics.TraceEventType * int -> unit

Public Sub WriteEntry (message As String, severity As TraceEventType, id As Integer)

Parametry

message

String

Required. Zpráva, která se má protokolovat. Pokud message ano Nothing, použije se prázdný řetězec.

severity

TraceEventType

Typ zprávy. Ve výchozím nastavení TraceEventType.Information.

id

Int32

Identifikátor zprávy, obvykle používaný pro korelaci. Ve výchozím nastavení souvisí s popisem entryType v tabulce.

Výjimky

InvalidEnumArgumentException

Typ zprávy není jednou z hodnot výčtu TraceEventType .

SecurityException

Kód s částečnou důvěryhodností volá metodu, ale zapisuje do naslouchacího procesu protokolu událostí, který vyžaduje úplný vztah důvěryhodnosti.

Příklady

Tento příklad ukazuje, jak použít metodu My.Application.Log.WriteEntry k protokolování informací o trasování. Další informace naleznete v tématu Postupy: Zápis zpráv protokolu.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Tento příklad kódu se může spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteEntry nastavení My.Log.WriteEntry webových aplikací.

Poznámky

Metoda WriteEntry zapíše zprávu do naslouchacích procesů protokolu událostí aplikace.

V klientských aplikacích Log je objekt dostupný prostřednictvím objektu My.Application.Log . Ve webových aplikacích Log je objekt dostupný prostřednictvím objektu My.Log .

Informace o tom, které naslouchací procesy protokolu přijímají WriteEntry zprávy metody, najdete v části Návod: Určení, kde My.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolu můžete změnit. Další informace naleznete v tématu Práce s protokoly aplikací.

Pro přetížení, které nepřebírají id argument, je zapsáno id do protokolu definováno v následující tabulce.

severity	Výchozí id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

Následující tabulka uvádí příklady úkolů zahrnujících metodu WriteEntry .

To	Podívejte se
Zápis informací o událostech do naslouchacích procesů protokolu aplikace	Postupy: Zápis zpráv protokolu
Určení, kde Log se zapisují informace	Návod: Určení, kde my.application.log zapisuje informace

Dostupnost podle typu projektu

Typ projektu	Available
Aplikace pro systém Windows	Yes
Knihovna tříd	Yes
Konzolová aplikace	Yes
Knihovna ovládacích prvků systému Windows	Yes
Knihovna webových ovládacích prvků	No
Služba systému Windows	Yes
Web	Yes

Viz také

• TraceEventType
• Objekty (Visual Basic)
• Working with Application Logs in Visual Basic
• Postupy: Zápis zpráv protokolu
• Návod: Určení, kde my.application.log zapisuje informace