Compartir a través de

Realizar el seguimiento del uso de un archivo de texto

Este tema es aplicable a Windows Workflow Foundation 4.

En este ejemplo se muestra cómo ampliar el seguimiento en Windows Workflow Foundation (WF) creando un participante de seguimiento personalizado. Los participantes de seguimiento son clases de .NET Framework que reciben registros de seguimiento del motor en tiempo de ejecución a medida que se emiten. Puede crear un participante de seguimiento para transportar los eventos de seguimiento al destino necesario para su escenario. Por ejemplo, como parte de .NET Framework se proporciona el participante de seguimiento de ETW (Seguimiento de eventos para Windows). El participante de seguimiento de este ejemplo escribe los registros en formato XML en un archivo de texto.

Detalles del ejemplo

Para optimizar la utilidad y solidez del participante de seguimiento, deben completarse algunos pasos adicionales para conectar correctamente el participante de seguimiento al motor en tiempo de ejecución. En la siguiente tabla se describen las clases utilizadas en este ejemplo para crear un participante de seguimiento que obedece los procedimientos recomendados.

Clase Descripción

TextFileTrackingExtensionElement

Se utiliza una clase BehaviorExtensionElement para definir la sección de configuración utilizada para configurar el participante de seguimiento de archivo de texto. Esto permite a los usuarios especificar el destino del archivo de registro utilizando archivos de configuración estándar de .NET Framework.

TextFileTrackingBehavior

Los comportamientos de WCF permiten a los usuarios insertar extensiones en tiempo de ejecución. Este comportamiento agrega el participante de seguimiento al servicio cuando este se inicia.

TextFileTrackingParticipant

El participante de seguimiento que recibe los participantes de seguimiento en tiempo de ejecución y los almacena en un archivo de registro como XML.

Configuración de elementos de extensión de comportamiento

Para usar mediante archivos de configuración de .NET Framework el elemento de extensión de comportamiento previamente descrito, se necesita un paso más. En los archivos de configuración donde se va a usar la extensión se debe incluir la siguiente configuración.

<system.serviceModel>
    <extensions>
      <behaviorExtensions>
        <add name="textFileTracking" type="Microsoft.Samples.TextFileTracking.TextFileTrackingExtensionElement, WFStockPriceApplication, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      </behaviorExtensions>
    </extensions>
…
  </system.serviceModel>
Ee667247.note(es-es,VS.100).gifNota:
Vea el archivo Web.config del ejemplo para el uso del ejemplo completo de la configuración de elementos de extensión de comportamiento.

Registros de seguimiento personalizados

El archivo GetStockPrices.cs muestra cómo crear registros de seguimiento personalizados desde una actividad CodeActivity. Busque este registro al ejecutar el ejemplo.

Para utilizar este ejemplo

  1. Abra el archivo de solución de WFStockPriceApplication.sln con Visual Studio 2010.

  2. Presione F6 para compilar la solución.

  3. Presione CTRL+F5 para ejecutar la solución.

    La ventana del explorador se abre y muestra la lista de directorios de la aplicación.

  4. En el explorador, haga clic en StockPriceService.xamlx.

  5. El explorador muestra la página StockPriceService, que contiene la dirección wsdl de servicio local. Copie esta dirección.

    Un ejemplo de dirección wsdl de servicio local es https://localhost:53797/StockPriceService.xamlx?wsdl.

  6. Mediante el Explorador de Windows, vaya a la carpeta de Visual Studio 2010 (la carpeta de instalación predeterminada es %SystemDrive%\Archivos de programa\Microsoft Visual Studio 10.0). A continuación, busque la subcarpeta Common7\IDE\.

  7. Haga doble clic en el archivo WcfTestClient.exe para iniciar el Cliente de prueba WCF.

  8. En el Cliente de prueba WCF, seleccione Agregar servicio… en el menú Archivo.

  9. Pegue en el cuadro de texto la dirección URL que acaba de copiar.

  10. Haga clic en Aceptar para cerrar el cuadro de diálogo.

  11. Pruebe el servicio con el Cliente de prueba WCF.

    1. En el Cliente de prueba WCF, haga doble clic en GetStockPrice() bajo el nodo IStockPriceService.

      En el recuadro derecho aparece el método GetStockPrice(), con un parámetro.

    2. Escriba Contoso como valor para el parámetro.

    3. Haga clic en Invocar.

  12. Vea los eventos seguidos en el archivo de registro localizado en el directorio de datos de la aplicación en %APPDATA%\trackingRecords.log.

    Ee667247.note(es-es,VS.100).gifNota:
    %APPDATA% es una variable de entorno que se resuelve como %SystemDrive%\Users\<nombreDeUusuario>\AppData\Roaming en Windows Vista, Windows Server 2008 o Windows Server 2008.

Ee667247.Important(es-es,VS.100).gif Nota:
Puede que los ejemplos ya estén instalados en su equipo. Compruebe el siguiente directorio (valor predeterminado) antes de continuar.

<unidadDeInstalación>:\WF_WCF_Samples

Si no existe este directorio, vaya a la página de ejemplos de Windows Communication Foundation (WCF) y Windows Workflow Foundation (WF) Samples para .NET Framework 4 para descargar todos los ejemplos de WF y Windows Communication Foundation (WCF). Este ejemplo se encuentra en el siguiente directorio.

<unidadDeInstalación>:\WF_WCF_Samples\WF\Basic\Tracking\TextFileTracking