Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

DelimitedListTraceListener (Clase)

Dirige los resultados de traza o de depuración a un escritor de texto, como un escritor de secuencias, o a una secuencia, como una secuencia de archivo.

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

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public class DelimitedListTraceListener : TextWriterTraceListener

El tipo DelimitedListTraceListener expone los siguientes miembros.

  NombreDescripción
Método públicoDelimitedListTraceListener(Stream)Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el flujo de salida especificado.
Método públicoDelimitedListTraceListener(String)Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el archivo especificado.
Método públicoDelimitedListTraceListener(TextWriter)Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el escritor de texto especificado.
Método públicoDelimitedListTraceListener(Stream, String)Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el flujo de salida especificado y tiene el nombre especificado.
Método públicoDelimitedListTraceListener(String, String)Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el archivo especificado y tiene el nombre especificado.
Método públicoDelimitedListTraceListener(TextWriter, String)Inicializa una nueva instancia de la clase DelimitedListTraceListener que escribe en el escritor de texto especificado y tiene el nombre especificado.
Arriba

  NombreDescripción
Propiedad públicaAttributesObtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación. (Se hereda de TraceListener).
Propiedad públicaDelimiterObtiene o establece el delimitador de la lista delimitada.
Propiedad públicaFilterObtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento. (Se hereda de TraceListener).
Propiedad públicaIndentLevelObtiene o establece el nivel de sangría. (Se hereda de TraceListener).
Propiedad públicaIndentSizeObtiene o establece el número de espacios de una sangría. (Se hereda de TraceListener).
Propiedad públicaIsThreadSafeObtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. (Se hereda de TraceListener).
Propiedad públicaNameObtiene o establece un nombre para este objeto TraceListener. (Se hereda de TraceListener).
Propiedad protegidaNeedIndentObtiene o establece un valor que indica si se va a aplicar sangría a los resultados. (Se hereda de TraceListener).
Propiedad públicaTraceOutputOptionsObtiene o establece las opciones de los resultados de seguimiento. (Se hereda de TraceListener).
Propiedad públicaWriterObtiene o establece el escritor de texto que recibe los resultados de la traza o la depuración. (Se hereda de TextWriterTraceListener).
Arriba

  NombreDescripción
Método públicoCloseCierra Writer para que ya no se reciba ningún resultado de la traza o la depuración. (Se hereda de TextWriterTraceListener).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDispose()Libera todos los recursos utilizados por TraceListener. (Se hereda de TraceListener).
Método protegidoDispose(Boolean)Infraestructura. Desecha este objeto TextWriterTraceListener. (Se hereda de TextWriterTraceListener).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método públicoFail(String)Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoFail(String, String)Emite un mensaje de error y un mensaje de error detallado para el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFlushVacía el búfer de resultados de la propiedad Writer. (Se hereda de TextWriterTraceListener).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetSupportedAttributesDevuelve el atributo de archivo de configuración personalizado que admite el agente de escucha de seguimiento delimitado. (Invalida a TraceListener.GetSupportedAttributes()).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoTraceData(TraceEventCache, String, TraceEventType, Int32, Object)Escribe la información de seguimiento, un objeto de datos y la información de evento en el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object)).
Método públicoTraceData(TraceEventCache, String, TraceEventType, Int32, Object[])Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32)Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. (Se hereda de TraceListener).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)Escribe la información de seguimiento, un mensaje y la información de evento en el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])Escribe la información de seguimiento, una matriz de objetos con formato y la información de evento en el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])).
Método públicoTraceTransferEscribe la información de seguimiento, un mensaje, una identidad de actividad relacionada y la información de evento en los resultados específicos del agente de escucha. (Se hereda de TraceListener).
Método públicoWrite(Object)Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoWrite(String)Escribe un mensaje en la propiedad Writer de esta instancia. (Se hereda de TextWriterTraceListener).
Método públicoWrite(Object, String)Escribe un nombre de categoría y el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoWrite(String, String)Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método protegidoWriteIndentEscribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false. (Se hereda de TraceListener).
Método públicoWriteLine(Object)Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguido de un terminador de línea. (Se hereda de TraceListener).
Método públicoWriteLine(String)Escribe en la propiedad Writer de esta instancia un mensaje seguido de un terminador de línea. El terminador de línea predeterminado corresponde a un retorno de carro seguido de un avance de línea (\r\n). (Se hereda de TextWriterTraceListener).
Método públicoWriteLine(Object, String)Escribe un nombre de categoría y el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea. (Se hereda de TraceListener).
Método públicoWriteLine(String, String)Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea. (Se hereda de TraceListener).
Arriba

El resultado de seguimiento tiene un formato de texto delimitado que utiliza el delimitador especificado por la propiedad Delimiter. El delimitador se utiliza para finalizar cada campo en una línea de salida. Por ejemplo, para mostrar el seguimiento generado en una hoja de cálculo de Microsoft Excel se podría especificar una coma (",") como un delimitador y crear un archivo de valores separados por comas (archivo .csv).

Nota importanteImportante

interfaz deIDisposable . Cuando haya terminado de utilizar el tipo, se debe eliminar de directa o indirectamente. Para desechar de tipo directamente, llame al método de Dispose en un bloque detry/decatch . Para desechar de indirectamente, utilice una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, vea “Uso de objeto que implementa sección IDisposable” en el tema de la interfaz de IDisposable .

Se puede habilitar o deshabilitar un DelimitedListTraceListener a través del archivo de configuración de la aplicación y, a continuación, utilizar el DelimitedListTraceListener configurado en la aplicación. Asimismo, se puede crear un DelimitedListTraceListener en el código.

NotaNota

El DelimitedListTraceListener solo delimita texto que se emite utilizando métodos cuyos nombres comienzan por la palabra Trace, como DelimitedListTraceListener.TraceEvent o Trace.TraceWarning. Los datos de seguimiento emitidos utilizando los métodos Debug.Write y TextWriterTraceListener.WriteLine no están delimitados.

Para configurar DelimitedListTraceListener, modifique el archivo de configuración que corresponde al nombre de la aplicación. En este archivo, se puede agregar un agente de escucha, establecer las propiedades de un agente de escucha o quitar un agente de escucha. El archivo de configuración debería tener el formato que se muestra en el siguiente ejemplo:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="delimitedListener" 
          type="System.Diagnostics.DelimitedListTraceListener" 
          delimiter="," 
          initializeData="delimitedOutput.csv" 
          traceOutputOptions="ProcessId, DateTime" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>
NotaNota

Si se intenta escribir en un archivo que está en uso o no está disponible, delante del nombre del archivo se agrega automáticamente un identificador único global (GUID).

NotaNota

Los agentes de escucha los utilizan los métodos de las clases Debug, Trace y TraceSource para escribir la información de seguimiento. No se debe llamar a los métodos de agente de escucha, salvo los constructores, directamente desde el código de aplicación.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de propiedad Resources: Synchronization. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.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.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft