XmlSerializerFormatAttribute Class

Definition

Namespace:

System.ServiceModel

Assemblies:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v10.0.652802

Source:

XmlSerializerFormatAttribute.cs

Instructs the Windows Communication Foundation (WCF) infrastructure to use the XmlSerializer instead of the XmlObjectSerializer.

public ref class XmlSerializerFormatAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
public sealed class XmlSerializerFormatAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
type XmlSerializerFormatAttribute = class
    inherit Attribute

Public NotInheritable Class XmlSerializerFormatAttribute
Inherits Attribute

Inheritance

Object

Attribute

XmlSerializerFormatAttribute

Attributes

AttributeUsageAttribute

Examples

The following example applies the XmlSerializerFormatAttribute to an interface.

[ServiceContract, XmlSerializerFormat(Style = OperationFormatStyle.Rpc,
    Use = OperationFormatUse.Encoded)]
public interface ICalculator
{
    [OperationContract, XmlSerializerFormat(Style = OperationFormatStyle.Rpc,
        Use = OperationFormatUse.Encoded)]
    double Add(double a, double b);
}

<ServiceContract(), XmlSerializerFormat(Style := OperationFormatStyle.Rpc, _
   Use := OperationFormatUse.Encoded)>  _
Public Interface ICalculator
    <OperationContract(), XmlSerializerFormat(Style := OperationFormatStyle.Rpc, _
        Use := OperationFormatUse.Encoded)>  _
    Function Add(ByVal a As Double, ByVal b As Double) As Double 
End Interface

Remarks

This attribute is similar to the DataContractFormatAttribute attribute. Both attributes can be applied to a method, class, or interface.

For more information about the XmlSerializer, see Using the XmlSerializer Class.

A method can have either of the two attributes applied, but not both. Any operation that has neither applied uses the attribute applied to the containing class. If the containing class does not have either attribute applied, the DataContractSerializer is used.

Applying the attribute also causes a XmlSerializerOperationBehavior to be created at runtime. The behavior allows customization at runtime of the serializer behavior.

Constructors

Name	Description
XmlSerializerFormatAttribute()	Initializes a new instance of the XmlSerializerFormatAttribute class.

Properties

Name	Description
Style	Gets or sets the SOAP style of the XmlSerializer.
SupportFaults	Gets or sets a value that indicates that the XmlSerializer should be used for reading and writing faults.
Use	Gets or sets a value that specifies the format to use.

See also

• XmlSerializerOperationBehavior
• DataContractSerializer
• XmlSerializer
• Using the XmlSerializer Class