Trace.Write Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapisuje informacje o śledzeniu do odbiorników śledzenia w kolekcji Listeners .
Przeciążenia
Write(Object) |
Zapisuje wartość metody obiektu ToString() w odbiornikach śledzenia w kolekcji Listeners . |
Write(String) |
Zapisuje komunikat do odbiorników śledzenia w kolekcji Listeners . |
Write(Object, String) |
Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiorników śledzenia w Listeners kolekcji. |
Write(String, String) |
Zapisuje nazwę kategorii i komunikat do odbiorników śledzenia w kolekcji Listeners . |
Write(Object)
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
Zapisuje wartość metody obiektu ToString() w odbiornikach śledzenia w kolekcji Listeners .
public:
static void Write(System::Object ^ value);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object? value);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object value);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : obj -> unit
Public Shared Sub Write (value As Object)
Parametry
- Atrybuty
Przykłady
W poniższym przykładzie zostanie utworzona nazwana TraceSwitchgeneralSwitch
. Ten przełącznik jest ustawiany poza przykładem kodu.
Jeśli przełącznik jest ustawiony na TraceLevelError
wartość lub wyższą, przykład zwraca imię parametru value
do .Listeners Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .
Następnie, jeśli TraceLevel parametr ma wartość Verbose
, przykład zwraca komunikat w tym samym wierszu co pierwszy komunikat. Po drugim komunikacie następuje terminator wiersza.
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level
// is set to Error or higher.
if ( generalSwitch->TraceError )
{
Trace::Write( myObject );
}
// Write a second message if the TraceSwitch level
// is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::WriteLine( " is not a valid value for this method." );
}
#endif
}
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");
static public void MyErrorMethod(Object myObject) {
// Write the message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Trace.Write(myObject);
// Write a second message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Trace.WriteLine(" is not a valid value for this method.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")
Public Shared Sub MyErrorMethod(myObject As Object)
' Write the message if the TraceSwitch level is set to Error or higher.
If generalSwitch.TraceError Then
Trace.Write(myObject)
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Trace.WriteLine(" is not a valid value for this method.")
End If
End Sub
Uwagi
Domyślnie dane wyjściowe są zapisywane w wystąpieniu klasy DefaultTraceListener.
Ta metoda wywołuje metodę Write odbiornika śledzenia.
Uwaga
ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj Page.Trace właściwości .
Domyślnie w kodzie skojarzonym z ASP.NET stroną sieci Web instrukcja Trace.Write("...")
jest wywołaniem Write metody Page.Trace właściwości . Aby użyć System.Diagnostics.Trace klasy na stronach sieci Web, musisz uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...")
.
Zobacz też
Dotyczy
Write(String)
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
Zapisuje komunikat do odbiorników śledzenia w kolekcji Listeners .
public:
static void Write(System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : string -> unit
Public Shared Sub Write (message As String)
Parametry
- message
- String
Komunikat do zapisu.
- Atrybuty
Przykłady
W poniższym przykładzie zostanie utworzona nazwana TraceSwitchgeneralSwitch
. Ten przełącznik jest ustawiany poza przykładem kodu.
Jeśli przełącznik jest ustawiony na TraceLevelError
lub wyższy, przykład zwraca pierwszy komunikat o błędzie do .Listeners Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .
Następnie, jeśli TraceLevel parametr ma wartość Verbose
, przykład zwraca drugi komunikat o błędzie w tym samym wierszu co pierwszy komunikat. Terminator wiersza jest zgodny z drugim komunikatem.
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod()
{
// Write the message if the TraceSwitch level is set
// to Error or higher.
if ( generalSwitch->TraceError )
{
Trace::Write( "My error message. " );
}
// Write a second message if the TraceSwitch level is set
// to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::WriteLine( "My second error message." );
}
}
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");
static public void MyErrorMethod() {
// Write the message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Trace.Write("My error message. ");
// Write a second message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Trace.WriteLine("My second error message.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")
Public Shared Sub MyErrorMethod()
' Write the message if the TraceSwitch level is set to Error or higher.
If generalSwitch.TraceError Then
Trace.Write("My error message. ")
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Trace.WriteLine("My second error message.")
End If
End Sub
Uwagi
Domyślnie dane wyjściowe są zapisywane w wystąpieniu klasy DefaultTraceListener.
Ta metoda wywołuje metodę Write odbiornika śledzenia.
Uwaga
ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj Page.Trace właściwości .
Domyślnie w kodzie skojarzonym z ASP.NET stroną sieci Web instrukcja Trace.Write("...")
jest wywołaniem Write metody Page.Trace właściwości . Aby użyć System.Diagnostics.Trace klasy na stronach sieci Web, musisz uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...")
.
Zobacz też
Dotyczy
Write(Object, String)
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiorników śledzenia w Listeners kolekcji.
public:
static void Write(System::Object ^ value, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object? value, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object value, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : obj * string -> unit
Public Shared Sub Write (value As Object, category As String)
Parametry
- category
- String
Nazwa kategorii, używana do organizowania danych wyjściowych.
- Atrybuty
Przykłady
W poniższym przykładzie zostanie utworzona nazwana TraceSwitchgeneralSwitch
. Ten przełącznik jest ustawiany poza przykładem kodu.
Jeśli przełącznik jest ustawiony na TraceLevelVerbose
, przykład zwraca nazwę myObject
i do category
Listeners. Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .
Następnie, jeśli TraceLevel parametr jest ustawiony na Error
lub wyższy, przykład zwraca drugi komunikat o błędzie w tym samym wierszu co pierwszy komunikat. Po drugim komunikacie następuje terminator wiersza.
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::Write( myObject, category );
}
// Write a second message if the TraceSwitch level is set to
// Error or higher.
if ( generalSwitch->TraceError )
{
Trace::WriteLine( " Object is not valid for this category." );
}
#endif
}
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");
static public void MyErrorMethod(Object myObject, string category) {
// Write the message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Trace.Write(myObject, category);
// Write a second message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Trace.WriteLine(" Object is not valid for this category.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")
Public Shared Sub MyErrorMethod(myObject As Object, category As String)
' Write the message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Trace.Write(myObject, category)
End If
' Write a second message if the TraceSwitch level is set to Error or higher.
If generalSwitch.TraceError Then
Trace.WriteLine(" Object is not valid for this category.")
End If
End Sub
Uwagi
Domyślnie dane wyjściowe są zapisywane w wystąpieniu klasy DefaultTraceListener.
Parametr category
może służyć do grupowania komunikatów wyjściowych.
Ta metoda wywołuje metodę Write odbiornika śledzenia.
Uwaga
ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj Page.Trace właściwości .
Domyślnie w kodzie skojarzonym z ASP.NET stroną sieci Web instrukcja Trace.Write("...")
jest wywołaniem Write metody Page.Trace właściwości . Aby użyć System.Diagnostics.Trace klasy na stronach sieci Web, musisz uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...")
.
Zobacz też
Dotyczy
Write(String, String)
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
- Źródło:
- Trace.cs
Zapisuje nazwę kategorii i komunikat do odbiorników śledzenia w kolekcji Listeners .
public:
static void Write(System::String ^ message, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string? message, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string message, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : string * string -> unit
Public Shared Sub Write (message As String, category As String)
Parametry
- message
- String
Komunikat do zapisu.
- category
- String
Nazwa kategorii, używana do organizowania danych wyjściowych.
- Atrybuty
Przykłady
W poniższym przykładzie zostanie utworzona nazwana TraceSwitchgeneralSwitch
. Ten przełącznik jest ustawiany poza przykładem kodu.
Jeśli przełącznik jest ustawiony na TraceLevelVerbose
, przykład zwraca pierwszy komunikat o błędzie do .Listeners Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .
Następnie, jeśli TraceLevel parametr jest ustawiony na Error
lub wyższy, przykład zwraca drugi komunikat o błędzie w tym samym wierszu co pierwszy komunikat. Po drugim komunikacie następuje terminator wiersza.
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::Write( String::Concat( myObject,
" is not a valid object for category: " ), category );
}
// Write a second message if the TraceSwitch level is set to
// Error or higher.
if ( generalSwitch->TraceError )
{
Trace::WriteLine( " Please use a different category." );
}
#endif
}
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");
static public void MyErrorMethod(Object myObject, string category) {
// Write the message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Trace.Write(myObject.ToString() + " is not a valid object for category: ",
category);
// Write a second message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Trace.WriteLine(" Please use a different category.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")
Public Shared Sub MyErrorMethod(myObject As Object, category As String)
' Write the message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Trace.Write(myObject.ToString() & _
" is not a valid object for category: ", category)
End If
' Write a second message if the TraceSwitch level is set to Error or higher.
If generalSwitch.TraceError Then
Trace.WriteLine(" Please use a different category.")
End If
End Sub
Uwagi
Domyślnie dane wyjściowe są zapisywane w wystąpieniu klasy DefaultTraceListener.
Parametr category
może służyć do grupowania komunikatów wyjściowych.
Ta metoda wywołuje metodę Write odbiornika śledzenia.
Uwaga
ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj Page.Trace właściwości .
Domyślnie w kodzie skojarzonym z ASP.NET stroną sieci Web instrukcja Trace.Write("...")
jest wywołaniem Write metody Page.Trace właściwości . Aby użyć System.Diagnostics.Trace klasy na stronach sieci Web, musisz uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...")
.
Zobacz też
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla