Esempio di XMLSerializer

Nell'esempio XmlSerializer viene illustrato come serializzare e deserializzare i tipi compatibili con .XmlSerializer Il formattatore predefinito di Windows Communication Foundation (WCF) è la DataContractSerializer classe . La XmlSerializer classe può essere utilizzata per serializzare e deserializzare i tipi quando la DataContractSerializer classe non può essere usata. Questo è spesso il caso in cui è necessario un controllo preciso sul codice XML, ad esempio se una parte di dati deve essere un attributo XML e non un elemento XML. Inoltre, XmlSerializer viene spesso selezionato automaticamente durante la creazione di client per servizi non WCF.

In questo esempio il client è un'applicazione console (.exe) e il servizio è ospitato da Internet Information Services (IIS).

Annotazioni

La procedura di installazione e le istruzioni di compilazione per questo esempio si trovano alla fine di questo argomento.

L'oggetto ServiceContractAttribute e XmlSerializerFormatAttribute deve essere applicato all'interfaccia come illustrato nel codice di esempio seguente.

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"), XmlSerializerFormat]
public interface IXmlSerializerCalculator
{
    [OperationContract]
    ComplexNumber Add(ComplexNumber n1, ComplexNumber n2);
    [OperationContract]
    ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2);
    [OperationContract]
    ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2);
    [OperationContract]
    ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2);
}

I membri pubblici della ComplexNumber classe vengono serializzati da XmlSerializer come attributi XML. Impossibile utilizzare il DataContractSerializer per creare questo tipo di istanza XML.

public class ComplexNumber
{
    private double real;
    private double imaginary;

    [XmlAttribute]
    public double Real
    {
        get { return real; }
        set { real = value; }
    }

    [XmlAttribute]
    public double Imaginary
    {
        get { return imaginary; }
        set { imaginary = value; }
    }

    public ComplexNumber(double real, double imaginary)
    {
        this.Real = real;
        this.Imaginary = imaginary;
    }
    public ComplexNumber()
    {
        this.Real = 0;
        this.Imaginary = 0;
    }

}

L'implementazione del servizio calcola e restituisce il risultato appropriato, accettando e restituendo valori del ComplexNumber tipo.

public class XmlSerializerCalculatorService : IXmlSerializerCalculator
{
    public ComplexNumber Add(ComplexNumber n1, ComplexNumber n2)
    {
        return new ComplexNumber(n1.Real + n2.Real, n1.Imaginary +
                                                      n2.Imaginary);
    }
    …
}

L'implementazione client usa anche numeri complessi. Sia il contratto di servizio che i tipi di dati sono definiti nel file di origine generatedClient.cs, generato dallo strumento utilità metadati ServiceModel (Svcutil.exe) dai metadati del servizio. Svcutil.exe può rilevare quando un contratto non è serializzabile da DataContractSerializer e in questo caso torna a emettere tipi XmlSerializable. Se si desidera forzare l'uso di XmlSerializer, è possibile passare l'opzione di comando /serializer:XmlSerializer (usare XmlSerializer) allo strumento Svcutil.exe.

// Create a client.
XmlSerializerCalculatorClient client = new
                         XmlSerializerCalculatorClient();

// Call the Add service operation.
ComplexNumber value1 = new ComplexNumber();
value1.Real = 1;
value1.Imaginary = 2;
ComplexNumber value2 = new ComplexNumber();
value2.Real = 3;
value2.Imaginary = 4;
ComplexNumber result = client.Add(value1, value2);
Console.WriteLine("Add({0} + {1}i, {2} + {3}i) = {4} + {5}i",
    value1.Real, value1.Imaginary, value2.Real, value2.Imaginary,
    result.Real, result.Imaginary);
    …
}

Quando si esegue l'esempio, le richieste e le risposte dell'operazione vengono visualizzate nella finestra della console client. Premere INVIO nella finestra del client per chiudere il client.

Add(1 + 2i, 3 + 4i) = 4 + 6i
Subtract(1 + 2i, 3 + 4i) = -2 + -2i
Multiply(2 + 3i, 4 + 7i) = -13 + 26i
Divide(3 + 7i, 5 + -2i) = 0.0344827586206897 + 1.41379310344828i

Press <ENTER> to terminate client.

Per configurare, compilare ed eseguire l'esempio

1. Assicurati di aver eseguito la procedura di installazione di One-Time per gli esempi di Windows Communication Foundation.

2. Per compilare l'edizione C# o Visual Basic .NET della soluzione, seguire le istruzioni in Compilazione degli esempi di Windows Communication Foundation.

3. Per eseguire l'esempio in una configurazione con computer singolo o incrociato, seguire le istruzioni riportate in Esecuzione degli esempi di Windows Communication Foundation.