Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

Trace.Write (Método) (Object, String)

Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

[ConditionalAttribute("TRACE")]
public static void Write(
	Object value,
	string category
)

Parámetros

value
Tipo: System.Object
Se envía un nombre Object a Listeners.
category
Tipo: System.String
Nombre de categoría utilizado para organizar el resultado.

El resultado se escribe de forma predeterminada en una instancia de DefaultTraceListener.

El parámetro category puede utilizarse para agrupar mensajes de resultados.

Este método llama al método Write del agente de escucha de seguimiento.

NotaNota

ASP.NET proporciona funcionalidad de traza especialmente diseñada para las páginas Web. Para escribir mensajes de traza en las páginas ASP.NET, utilice la propiedad Page.Trace. Para obtener más información sobre cómo realizar la traza en las páginas ASP.NET, vea Información general sobre la traza en ASP.NET.

De forma predeterminada, en el código asociado a una página Web ASP.NET, la instrucción Trace.Write("...") es una llamada al método Write de la propiedad Page.Trace. Para utilizar la clase System.Diagnostics.Trace en páginas Web, es preciso incluir el espacio de nombres, por ejemplo, System.Diagnostics.Trace.Write("...").

En el siguiente ejemplo se crea un TraceSwitch denominado generalSwitch. Este modificador se establece fuera de la muestra de código.

Si el modificador está establecido en TraceLevelVerbose, el ejemplo genera el nombre de myObject y el parámetro category en Listeners. Para obtener información sobre cómo agregar un agente de escucha a la colección Listeners, vea la clase TraceListenerCollection.

A continuación, si la enumeración TraceLevel está establecida en Error o superior, el ejemplo genera el segundo mensaje de error en la misma línea que el primer mensaje. El segundo mensaje va seguido de un terminador de línea.


// 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.");
 }



.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: