Log.WriteEntry Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

Scrive un messaggio nei listener del log dell'applicazione.

Overload

WriteEntry(String)	Scrive un messaggio nei listener del log dell'applicazione.
WriteEntry(String, TraceEventType)	Scrive un messaggio nei listener del log dell'applicazione.
WriteEntry(String, TraceEventType, Int32)	Scrive un messaggio nei listener del log dell'applicazione.

WriteEntry(String)

Scrive un messaggio nei listener del log dell'applicazione.

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

public void WriteEntry (string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parametri

message

String

Obbligatorio. Messaggio da registrare. Se message è Nothing, viene utilizzata una stringa vuota.

Eccezioni

SecurityException

Il metodo viene chiamato dal codice con attendibilità parziale che tuttavia consente di scrivere nel listener del registro eventi che richiede attendibilità totale.

Esempio

Questo esempio illustra come usare il metodo My.Application.Log.WriteEntry per registrare le informazioni di traccia. Per altre informazioni, vedere Procedura: Scrivere messaggi di log.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( 
        "Entering TracingTest with argument " & 
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( 
        "Exiting TracingTest with argument " & 
        fileName & ".")
End Sub

Questo esempio di codice può essere eseguito solo all'interno di un'applicazione client. Passare My.Application.Log.WriteEntry a My.Log.WriteEntry per le applicazioni Web.

Commenti

Il WriteEntry metodo scrive un messaggio nei listener del registro eventi dell'applicazione.

Nelle applicazioni client l'oggetto Log è disponibile tramite l'oggetto My.Application.Log . Nelle applicazioni Web l'oggetto Log è disponibile tramite l'oggetto My.Log .

Per informazioni sui listener di log che ricevono i WriteEntry messaggi del metodo, vedere Procedura dettagliata: Determinazione della posizione in cui My.Application.Log scrive informazioni. È possibile modificare i listener di log predefiniti. Per altre informazioni, vedere Uso dei log applicazione.

Per gli overload che non accettano l'argomento , l'oggetto idid scritto nel log è definito dalla tabella seguente.

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

Nella tabella seguente sono elencati esempi di attività che coinvolgono il WriteEntry metodo .

A	Vedere
Scrivere informazioni sugli eventi nei listener di log dell'applicazione	Procedura: Scrivere messaggi di log
Determinare dove Log scrive le informazioni	Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Di Windows	Sì
Libreria di controlli Web	No
Servizio Windows	Sì
Sito Web	Sì

Vedi anche

• TraceEventType
• Oggetti (Visual Basic)
• Utilizzo dei log applicazione in Visual Basic
• Procedura: Scrivere messaggi di log
• Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

WriteEntry(String, TraceEventType)

Scrive un messaggio nei listener del log dell'applicazione.

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)

Parametri

message

String

Obbligatorio. Messaggio da registrare. Se message è Nothing, viene utilizzata una stringa vuota.

severity

TraceEventType

Tipo di messaggio. Per impostazione predefinita, TraceEventType.Information.

Eccezioni

InvalidEnumArgumentException

Il tipo di messaggio non è uno dei valori di enumerazione TraceEventType.

SecurityException

Il metodo viene chiamato dal codice con attendibilità parziale che tuttavia consente di scrivere nel listener del registro eventi che richiede attendibilità totale.

Esempio

Questo esempio illustra come usare il metodo My.Application.Log.WriteEntry per registrare le informazioni di traccia. Per altre informazioni, vedere Procedura: Scrivere messaggi di log.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( 
        "Entering TracingTest with argument " & 
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( 
        "Exiting TracingTest with argument " & 
        fileName & ".")
End Sub

Questo esempio di codice può essere eseguito solo all'interno di un'applicazione client. Passare My.Application.Log.WriteEntry a My.Log.WriteEntry per le applicazioni Web.

Commenti

Il WriteEntry metodo scrive un messaggio nei listener del registro eventi dell'applicazione.

Nelle applicazioni client l'oggetto Log è disponibile tramite l'oggetto My.Application.Log . Nelle applicazioni Web l'oggetto Log è disponibile tramite l'oggetto My.Log .

Per informazioni sui listener di log che ricevono i WriteEntry messaggi del metodo, vedere Procedura dettagliata: Determinazione della posizione in cui My.Application.Log scrive informazioni. È possibile modificare i listener di log predefiniti. Per altre informazioni, vedere Uso dei log applicazione.

Per gli overload che non accettano l'argomento , l'oggetto idid scritto nel log è definito dalla tabella seguente.

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

Nella tabella seguente sono elencati esempi di attività che coinvolgono il WriteEntry metodo .

A	Vedere
Scrivere informazioni sugli eventi nei listener di log dell'applicazione	Procedura: Scrivere messaggi di log
Determinare dove Log scrive le informazioni	Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Di Windows	Sì
Libreria di controlli Web	No
Servizio Windows	Sì
Sito Web	Sì

Vedi anche

• TraceEventType
• Oggetti (Visual Basic)
• Utilizzo dei log applicazione in Visual Basic
• Procedura: Scrivere messaggi di log
• Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

WriteEntry(String, TraceEventType, Int32)

Scrive un messaggio nei listener del log dell'applicazione.

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)

Parametri

message

String

Obbligatorio. Messaggio da registrare. Se message è Nothing, viene utilizzata una stringa vuota.

severity

TraceEventType

Tipo di messaggio. Per impostazione predefinita, TraceEventType.Information.

id

Int32

Identificatore di messaggio, solitamente utilizzato per la correlazione. Per impostazione predefinita, correlato a entryType come descritto nella tabella.

Eccezioni

InvalidEnumArgumentException

Il tipo di messaggio non è uno dei valori di enumerazione TraceEventType.

SecurityException

Il metodo viene chiamato dal codice con attendibilità parziale che tuttavia consente di scrivere nel listener del registro eventi che richiede attendibilità totale.

Esempio

Questo esempio illustra come usare il metodo My.Application.Log.WriteEntry per registrare le informazioni di traccia. Per altre informazioni, vedere Procedura: Scrivere messaggi di log.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( 
        "Entering TracingTest with argument " & 
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( 
        "Exiting TracingTest with argument " & 
        fileName & ".")
End Sub

Questo esempio di codice può essere eseguito solo all'interno di un'applicazione client. Passare My.Application.Log.WriteEntry a My.Log.WriteEntry per le applicazioni Web.

Commenti

Il WriteEntry metodo scrive un messaggio nei listener del registro eventi dell'applicazione.

Nelle applicazioni client l'oggetto Log è disponibile tramite l'oggetto My.Application.Log . Nelle applicazioni Web l'oggetto Log è disponibile tramite l'oggetto My.Log .

Per informazioni sui listener di log che ricevono i WriteEntry messaggi del metodo, vedere Procedura dettagliata: Determinazione della posizione in cui My.Application.Log scrive informazioni. È possibile modificare i listener di log predefiniti. Per altre informazioni, vedere Uso dei log applicazione.

Per gli overload che non accettano l'argomento , l'oggetto idid scritto nel log è definito dalla tabella seguente.

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

Nella tabella seguente sono elencati esempi di attività che coinvolgono il WriteEntry metodo .

A	Vedere
Scrivere informazioni sugli eventi nei listener di log dell'applicazione	Procedura: Scrivere messaggi di log
Determinare dove Log scrive le informazioni	Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Di Windows	Sì
Libreria di controlli Web	No
Servizio Windows	Sì
Sito Web	Sì

Vedi anche

• TraceEventType
• Oggetti (Visual Basic)
• Utilizzo dei log applicazione in Visual Basic
• Procedura: Scrivere messaggi di log
• Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log