Procedura: dichiarare errori nei contratti di servizio

Articolo
02/27/2011

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.

Creare un contratto di servizio che contiene almeno un'operazione. Per un esempio, vedere Procedura: definire un contratto di servizio di Windows Communication Foundation.
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.
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.
```
<OperationContract, FaultContractAttribute(GetType(GreetingFault), Action:="https://www.contoso.com/GreetingFault", ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
Function SampleMethod(ByVal msg As String) As String
```
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

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.
```
  Throw New FaultException(Of GreetingFault)(New GreetingFault("A Greeting error occurred. You said: " & msg))
End If
```

Esempio

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

Imports System
Imports System.Collections.Generic
Imports System.Net.Security
Imports System.Runtime.Serialization
Imports System.ServiceModel
Imports System.Text

Namespace Microsoft.WCF.Documentation
  <ServiceContract(Namespace:="http://microsoft.wcf.documentation")> _
  Public Interface ISampleService
    <OperationContract, FaultContractAttribute(GetType(GreetingFault), Action:="https://www.contoso.com/GreetingFault", ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
    Function SampleMethod(ByVal msg As String) As String
  End Interface

  <DataContractAttribute> _
  Public Class GreetingFault
    Private report As String

    Public Sub New(ByVal message As String)
      Me.report = message
    End Sub

    <DataMemberAttribute> _
    Public Property Message() As String
      Get
          Return Me.report
      End Get
      Set(ByVal value As String)
          Me.report = value
      End Set
    End Property
  End Class

  Friend Class SampleService
      Implements ISampleService
  #Region "ISampleService Members"

  Public Function SampleMethod(ByVal msg As String) As String Implements ISampleService.SampleMethod
    Console.WriteLine("Client said: " & msg)
    ' Generate intermittent error behavior.
    Dim rand As New Random(DateTime.Now.Millisecond)
    Dim test As Integer = rand.Next(5)
    If test Mod 2 <> 0 Then
      Return "The service greets you: " & msg
    Else
      Throw New FaultException(Of GreetingFault)(New GreetingFault("A Greeting error occurred. You said: " & msg))
    End If
  End Function

  #End Region
  End Class
End Namespace

Vedere anche

Riferimento

System.ServiceModel.FaultContractAttribute
System.ServiceModel.FaultException

Condividi tramite