Trace.Write Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.TraceSource.dll

Zapisuje informacje o śledzeniu do odbiorników śledzenia w kolekcji Listeners.

Przeciążenia

Write(Object)	Zapisuje wartość metody ToString() obiektu 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 ToString() obiektu do odbiorników śledzenia w kolekcji Listeners.
Write(String, String)	Zapisuje nazwę kategorii i komunikat do odbiorników śledzenia w kolekcji Listeners.

Write(Object)

Źródło:

Trace.cs

Zapisuje wartość metody ToString() obiektu 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")>]
static member Write : obj -> unit

Public Shared Sub Write (value As Object)

Parametry

value

Object

Object, którego nazwa jest wysyłana do Listeners.

Atrybuty

ConditionalAttribute

Przykłady

Poniższy przykład tworzy TraceSwitch o nazwie generalSwitch. Ten przełącznik jest ustawiony poza przykładem kodu.

Jeśli przełącznik jest ustawiony na TraceLevelError lub nowszy, przykład zwraca imię parametru value do Listeners. Aby uzyskać informacje na temat dodawania odbiornika do kolekcji Listeners, zobacz klasę TraceListenerCollection.

Następnie, jeśli TraceLevel jest ustawiona na 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 DefaultTraceListener.

Ta metoda wywołuje metodę Write odbiornika śledzenia.

Nuta

ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj właściwości Page.Trace.

Domyślnie w kodzie skojarzonym ze stroną sieci Web ASP.NET instrukcja Trace.Write("...") jest wywołaniem metody Write właściwości Page.Trace. Aby użyć klasy System.Diagnostics.Trace na stronach sieci Web, należy uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...").

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Write(String)

Ź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")>]
static member Write : string -> unit

Public Shared Sub Write (message As String)

Parametry

message

String

Wiadomość do zapisu.

Atrybuty

ConditionalAttribute

Przykłady

Poniższy przykład tworzy TraceSwitch o nazwie generalSwitch. Ten przełącznik jest ustawiony poza przykładem kodu.

Jeśli przełącznik jest ustawiony na TraceLevelError lub nowszy, przykład zwraca pierwszy komunikat o błędzie do Listeners. Aby uzyskać informacje na temat dodawania odbiornika do kolekcji Listeners, zobacz klasę TraceListenerCollection.

Następnie, jeśli TraceLevel jest ustawiona na 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 DefaultTraceListener.

Ta metoda wywołuje metodę Write odbiornika śledzenia.

Nuta

ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj właściwości Page.Trace.

Domyślnie w kodzie skojarzonym ze stroną sieci Web ASP.NET instrukcja Trace.Write("...") jest wywołaniem metody Write właściwości Page.Trace. Aby użyć klasy System.Diagnostics.Trace na stronach sieci Web, należy uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...").

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Write(Object, String)

Źródło:

Trace.cs

Zapisuje nazwę kategorii i wartość metody ToString() obiektu do odbiorników śledzenia w kolekcji Listeners.

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")>]
static member Write : obj * string -> unit

Public Shared Sub Write (value As Object, category As String)

Parametry

value

Object

Nazwa Object jest wysyłana do Listeners.

category

String

Nazwa kategorii używana do organizowania danych wyjściowych.

Atrybuty

ConditionalAttribute

Przykłady

Poniższy przykład tworzy TraceSwitch o nazwie generalSwitch. Ten przełącznik jest ustawiony poza przykładem kodu.

Jeśli przełącznik jest ustawiony na TraceLevelVerbose, przykład zwraca nazwę myObject i category do Listeners. Aby uzyskać informacje na temat dodawania odbiornika do kolekcji Listeners, zobacz klasę TraceListenerCollection.

Następnie, jeśli TraceLevel jest ustawiona na Error lub wyższą, 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 DefaultTraceListener.

Parametr category może służyć do grupowania komunikatów wyjściowych.

Ta metoda wywołuje metodę Write odbiornika śledzenia.

Nuta

ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj właściwości Page.Trace.

Domyślnie w kodzie skojarzonym ze stroną sieci Web ASP.NET instrukcja Trace.Write("...") jest wywołaniem metody Write właściwości Page.Trace. Aby użyć klasy System.Diagnostics.Trace na stronach sieci Web, należy uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...").

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Write(String, String)

Ź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")>]
static member Write : string * string -> unit

Public Shared Sub Write (message As String, category As String)

Parametry

message

String

Wiadomość do zapisu.

category

String

Nazwa kategorii używana do organizowania danych wyjściowych.

Atrybuty

ConditionalAttribute

Przykłady

Poniższy przykład tworzy TraceSwitch o nazwie generalSwitch. Ten przełącznik jest ustawiony 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 kolekcji Listeners, zobacz klasę TraceListenerCollection.

Następnie, jeśli TraceLevel jest ustawiona na Error lub wyższą, 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 DefaultTraceListener.

Parametr category może służyć do grupowania komunikatów wyjściowych.

Ta metoda wywołuje metodę Write odbiornika śledzenia.

Nuta

ASP.NET dostarcza funkcje śledzenia dostosowane do stron sieci Web. Aby zapisać komunikaty śledzenia na stronach ASP.NET, użyj właściwości Page.Trace.

Domyślnie w kodzie skojarzonym ze stroną sieci Web ASP.NET instrukcja Trace.Write("...") jest wywołaniem metody Write właściwości Page.Trace. Aby użyć klasy System.Diagnostics.Trace na stronach sieci Web, należy uwzględnić przestrzeń nazw, na przykład System.Diagnostics.Trace.Write("...").

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute