XMLSerializer 範例

XmlSerializer 範例示範如何序列化和反序列化與 XmlSerializer相容的型別。 默認的 Windows Communication Foundation （WCF） 格式器是 DataContractSerializer 類別。 當 XmlSerializer 類別無法使用時，DataContractSerializer 類別可以用來串行化和還原串行化型別。 這通常是需要精確控制 XML 的情況，例如，如果數據片段必須是 XML 屬性，而不是 XML 元素。 此外，建立非 WCF 服務的用戶端時，XmlSerializer 通常會被自動選取。

在此範例中，用戶端是控制台應用程式（.exe），而服務是由 Internet Information Services （IIS） 所裝載。

備註

此範例的安裝程式和建置指示位於本主題結尾。

ServiceContractAttribute 和 XmlSerializerFormatAttribute 必須套用至介面上，如下列範例程式代碼所示。

[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);
}

類別 ComplexNumber 之中的公用成員會被 XmlSerializer 串行化為 XML 屬性。 DataContractSerializer無法用來建立這類 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;
    }

}

服務實作會計算並傳回適當的結果-接受和傳回型別 ComplexNumber 的值。

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

用戶端實作也會使用複數。 服務合約和數據類型都會定義在generatedClient.cs來源檔案中，這是由 ServiceModel 元數據公用程式工具 （Svcutil.exe） 從服務元數據產生的。 Svcutil.exe 可以偵測當合約無法被 DataContractSerializer 序列化時，會改為發送 XmlSerializable 型別。 如果您要強制使用 XmlSerializer，您可以將 /serializer：XmlSerializer （使用 XmlSerializer） 命令選項傳遞至 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);
    …
}

當您執行範例時，作業要求和回應會顯示在用戶端控制台視窗中。 在客戶端視窗中按 ENTER 鍵以關閉用戶端。

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.

要設定、建置和執行範例，請執行以下步驟：

1. 請確定您已針對 Windows Communication Foundation 範例 執行One-Time 安裝程式。

2. 若要建置解決方案的 C# 或 Visual Basic .NET 版本，請遵循建置 Windows Communication Foundation 範例 中中的指示。

3. 若要在單一或跨計算機組態中執行範例，請遵循執行 Windows Communication Foundation 範例 中的指示。