Образец XmlSerializer
Данный образец демонстрирует выполнение сериализации и десериализации типов, совместимых с XmlSerializer. Модуль форматирования Windows Communication Foundation (WCF) по умолчанию является классом DataContractSerializer. Класс XmlSerializer может быть использован для выполнения сериализации и десериализации типов в том случае, когда не может быть использован класс DataContractSerializer. Это часто происходит, когда требуется четкий контроль над XML — например, если фрагмент данных должен быть атрибутом XML, а не XML-элементом. Кроме того, сериализатор XmlSerializer часто выбирается автоматически при создании клиентов для служб, не относящихся к WCF.
В этом образце клиентом является консольное приложение (EXE), а служба размещается в службах 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 Metadata Utility Tool (Svcutil.exe) из метаданных службы. Svcutil.exe может определить, когда контракт не сериализуется с помощью сериализатора DataContractSerializer, и в этом случае возвращается к выдаче типов XmlSerializable. Если нужно принудительно использовать сериализатор XmlSerializer, можно указать в средстве Svcutil.exe параметр /serializer:XmlSerializer (использование XmlSerializer).
// 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);
…
}
При выполнении образца запросы и ответы операций отображаются в окне консоли клиента. Чтобы закрыть клиент, нажмите клавишу ВВОД в окне клиента.
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.
Настройка, построение и выполнение образца
Убедитесь, что выполнены процедуры, описанные в разделе Процедура однократной настройки образцов Windows Communication Foundation.
Чтобы выполнить построение версии решения для языка C# или Visual Basic .NET, следуйте инструкциям раздела Построение образцов Windows Communication Foundation.
Чтобы выполнить образец на одном или нескольких компьютерах, следуйте инструкциям в разделе Running the Windows Communication Foundation Samples.
![]() |
---|
Образцы уже могут быть установлены на компьютере. Перед продолжением проверьте следующий каталог (по умолчанию).
<диск_установки>:\WF_WCF_Samples
Если этот каталог не существует, перейдите на страницу Образцы Windows Communication Foundation (WCF) и Windows Workflow Foundation (WF) для .NET Framework 4, чтобы загрузить все образцы Windows Communication Foundation (WCF) и WF. Этот образец расположен в следующем каталоге.
<диск_установки>:\WF_WCF_Samples\WCF\Basic\Client\Interop\XmlSerializer
|