Diseñador de actividades TryCatch
El diseñador de actividades TryCatch se utiliza para crear y configurar una actividad TryCatch.
Actividad TryCatch
La actividad TryCatch contiene una actividad Try, una colección de propiedades Catch<TException> y una actividad Finally. Un Catch<TException> de tipo TException contiene ExceptionType y Action. Todas ellas se utilizan para implementar un mecanismo típico de control de errores basado en excepciones. Una actividad TryCatch intenta ejecutar su actividad Try. Si la actividad Try lanza algún tipo de excepción, la actividad TryCatch utiliza su colección Catch<TException> para buscar una coincidencia para la excepción. Si se encuentra una coincidencia, se ejecuta la propiedad Action de la clase Catch<TException> correspondiente, lo cual se utiliza como la lógica de control de errores para la excepción. Si las actividades de la sección Try se completan correctamente o las actividades de Catches se completan correctamente, la actividad TryCatch ejecuta su actividad Finally. Para obtener más información, vea Excepciones de Windows Workflow Foundation.
Utilizar el diseñador de actividades TryCatch
Acceda al diseñador de actividades TryCatch en la categoría Control de errores del Cuadro de herramientas.
El diseñador de actividades TryCatch se puede arrastrar desde el Cuadro de herramientas y colocarlo en la superficie del Diseñador de flujo de trabajo, donde se coloquen normalmente las actividades, como en una clase Sequence. Esto crea una actividad TryCatch con una propiedad DisplayName predeterminada de TryCatch. El valor DisplayName se puede editar en el encabezado del diseñador de actividades TryCatch o en el cuadro DisplayName de la cuadrícula de propiedades. Las otras propiedades deben editarse en la superficie del diseñador de actividades TryCatch.
Haga clic en el botón para expandir en la esquina superior derecha del diseñador TryCatch para ver los cuadros Try, Catches y Finally en la vista expandida. Para agregar una instrucción catch, haga clic en el botón Agregar nueva instrucción catch en el diseñador TryCatch. El botón cambia a un cuadro combinado de tipo. Seleccione un tipo de excepción y presione ENTRAR para agregar la instrucción catch. Una vez haya agregado una instrucción Catch, el área de captura se expande y se puede colocar una actividad en la instrucción catch para definir la lógica de ejecución de esta instrucción. Observe que hay un cuadro de texto a la derecha del área de la instrucción catch expandida. Puede asignar un nombre a la variable de excepción con este cuadro de texto. La variable de excepción solo se puede utilizar para las actividades en la misma instrucción Catch.
El diseñador TryCatch no admite la edición de Catch. Si desea cambiar el tipo de excepción, tiene que eliminar la instrucción Catch y agregar una nueva. Una instrucción Catch se puede eliminar si la selecciona y elimina o seleccionando Eliminar en el menú contextual que aparece al hacer clic con el botón derecho.
Propiedades TryCatch
En la tabla siguiente se muestran las propiedades TryCatch y se describe cómo se utilizan en el diseñador.
| Nombre de propiedad | Obligatorio | Uso |
|---|---|---|
| DisplayName | False | Especifica el nombre opcional descriptivo de la actividad TryCatch. El valor predeterminado es TryCatch. |
| Try | False | La actividad se ejecuta primero cuando TryCatch se ejecuta. |
| Catches | Falso | Colección de elementos Catch que se van a comprobar cuando la actividad Try produzca una excepción. Necesita agregar al menos una actividad en Catches o en el bloque Finally. |
| Finally | False | La actividad que se va a ejecutar cuando la clase Try y cualquiera de las actividades necesarias en la colección Catches completen la ejecución. Necesita agregar al menos una actividad en Catches o en el bloque Finally. |