Cierre y anule los recursos de versión de forma segura cuando se hayan quitado las conexiones de red

En el ejemplo UsingUsing se muestra el uso de los métodos Close y Abort para limpiar los recursos cuando se usa un cliente con tipo. La instrucción using provoca excepciones cuando la conexión de red no es sólida. Este ejemplo se basa en la Introducción que implementa un servicio de calculadora. En este ejemplo, el cliente es una aplicación de consola (.exe) y los Servicios de Internet Information Server (IIS) hospedan el servicio.

Este ejemplo muestra dos de los problemas comunes que se producen al utilizar el C# "utilizando" la instrucción con clientes escritos a máquina, así como el código que limpia correctamente después de las excepciones.

La instrucción C# "utilizando" resulta en una llamada a Dispose(). Esto es igual que Close(), que puede producir las excepciones cuando se produce un error en la red. Dado que la llamada a Dispose() ocurre implícitamente en la llave de cierre del bloque "utilizando", es probable que este origen de excepciones pase inadvertido a las personas que escriben el código y a las que leen el código. Esto representa un origen potencial de errores de aplicación.

El primer problema, mostrado en el método DemonstrateProblemUsingCanThrow, es que la llave de cierre inicia una excepción y el código no se ejecuta después de que la llave se cierre:

using (CalculatorClient client = new CalculatorClient())
{
    ...
} // <-- this line might throw
Console.WriteLine("Hope this code wasn't important, because it might not happen.");

Aun cuando nada dentro del bloque que se está utilizando produzca una excepción , o aunque todas las excepciones dentro del bloque que está siendo utilizando la detecten, Console.WriteLine no podrían ocurrir porque la llamada implícita Disposea la llave de cierre podría producir una excepción.

El segundo problema, mostrado en el método DemonstrateProblemUsingCanThrowAndMask, es que otra implicación de la llave de cierre produzca una excepción:

using (CalculatorClient client = new CalculatorClient())
{
    ...
    throw new ApplicationException("Hope this exception was not important, because "+
                                   "it might be masked by the Close exception.");
} // <-- this line might throw an exception.

Dado que Dispose() se produce dentro de un bloque "finalmente", el ApplicationException nunca se ve fuera del bloque que se está utilizando si se produce un error Dispose() . Si el código fuera de debe conocer sobre cuando ApplicationException produce, la construcción "utilizando" puede producir los problemas enmascarando esta excepción.

Finalmente, el ejemplo muestra correctamente cómo limpiar cuando se producen excepciones en DemonstrateCleanupWithExceptions. Esto utiliza un bloque prueba try/catch para crear informes errores y llamarAbort. Consulte el ejemplo Excepciones esperadas para obtener más detalles sobre cómo detectar las excepciones de las llamadas del cliente.

try
{
    ...
    client.Close();
}
catch (CommunicationException e)
{
    ...
    client.Abort();
}
catch (TimeoutException e)
{
    ...
    client.Abort();
}
catch (Exception e)
{
    ...
    client.Abort();
    throw;
}

Al ejecutar el ejemplo, las respuestas y excepciones de la operación se muestran en la ventana de la consola del cliente.

El proceso de cliente ejecuta tres escenarios, cada uno de los cuales intentan llamar Divide. El primer escenario muestra un código que está omitido debido a una excepción de Dispose(). El segundo escenario muestra una excepción importante enmascarándose debido a una excepción de Dispose(). El tercer escenario muestra el proceso de limpieza correcto.

El resultado esperado del proceso de cliente es:

=
= Demonstrating problem:  closing brace of using statement can throw.
=
Got System.ServiceModel.CommunicationException from Divide.
Got System.ServiceModel.Security.MessageSecurityException
=
= Demonstrating problem:  closing brace of using statement can mask other Exceptions.
=
Got System.ServiceModel.CommunicationException from Divide.
Got System.ServiceModel.Security.MessageSecurityException
=
= Demonstrating cleanup with Exceptions.
=
Calling client.Add(0.0, 0.0);
        client.Add(0.0, 0.0); returned 0
Calling client.Divide(0.0, 0.0);
Got System.ServiceModel.CommunicationException from Divide.

Press <ENTER> to terminate client.

Configurar, compilar y ejecutar el ejemplo

1. Asegúrese de que ha realizado el procedimiento de instalación única para los ejemplos de Windows Communication Foundation.

2. Para compilar el código C# o Visual Basic .NET Edition de la solución, siga las instrucciones de Building the Windows Communication Foundation Samples.

3. Para ejecutar el ejemplo en una configuración de una sola máquina o de varias máquinas, siga las instrucciones que se indican en Ejecución de los ejemplos de Windows Communication Foundation.