Procedura: dichiarare errori nei contratti di servizio

  • Articolo

Nel codice gestito, vengono generate eccezioni quando si verificano condizioni di errore. Nelle applicazioni Windows Communication Foundation (WCF), tuttavia, i contratti di servizio specificano quali informazioni sugli errori vengono restituite dai client dichiarando errori SOAP nel contratto di servizio. Per una panoramica sulla relazione tra eccezioni ed errori, vedere Specifica e gestione di errori in contratti e servizi.

Creare un contratto di servizio che specifica un errore SOAP.

  1. Creare un contratto di servizio che contiene almeno un'operazione. Per un esempio, vedere Procedura: definire un contratto di servizio di Windows Communication Foundation.

  2. Selezionare un'operazione che può specificare una condizione di errore in merito alla quale i client prevedono di ricevere una notifica. Per decidere quali condizioni di errore giustificano la restituzione di errori SOAP ai client, vedere Specifica e gestione di errori in contratti e servizi.

  3. Applicare una classe System.ServiceModel.FaultContractAttribute all'operazione selezionata e passare un tipo di errore serializzabile al costruttore. Per dettagli sulla creazione e l'utilizzo di tipi serializzabili, vedere Specifica del trasferimento di dati nei contratti di servizio. Nell'esempio seguente viene illustrato come specificare che l'operazione SampleMethod può produrre un GreetingFault.

  4. Ripetere i passaggi 2 e 3 per tutte le operazioni nel contratto che comunicano condizioni di errore ai client.

Implementazione di un'operazione per restituire un errore SOAP specificato

Dopo che un'operazione ha specificato che può essere restituito un determinato errore SOAP (come nella procedura seguente), per comunicare una condizione di errore a un'applicazione chiamante, il passaggio successivo consiste nell'implementare la specifica in questione.

Generare l'errore SOAP specificato nell'operazione

  1. Quando in un'operazione si verifica una condizione di errore specificata da FaultContractAttribute, generare una nuova eccezione System.ServiceModel.FaultException in cui l'errore SOAP specificato è il parametro di tipo. Nell'esempio seguente viene illustrato come generare il GreetingFault nel SampleMethod descritto nella procedura precedente e nella sezione Codice seguente.

Esempio

Nell'esempio di codice seguente viene illustrata un'implementazione di una singola operazione che specifica un GreetingFault per l'operazione SampleMethod.

Vedere anche

Riferimenti

System.ServiceModel.FaultContractAttribute
System.ServiceModel.FaultException