DataContractFormatAttribute Classe

Referência

Definição

Namespace:: System.ServiceModel

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Instrui a infraestrutura do WCF (Windows Communication Foundation) a usar o DataContractSerializer.

public ref class DataContractFormatAttribute sealed : Attribute

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

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

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

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

Public NotInheritable Class DataContractFormatAttribute
Inherits Attribute

Herança: Object

Attribute
DataContractFormatAttribute

Atributos: AttributeUsageAttribute

Exemplos

O exemplo a seguir aplica e DataContractFormatAttribute define a Style propriedade como Rpc. O estilo RPC é descrito na WSDL (Especificação da Linguagem de Descrição do Serviço Web).

[ServiceContract, DataContractFormat(Style = OperationFormatStyle.Rpc)]
interface ICalculator
{
    [OperationContract, DataContractFormat(Style = OperationFormatStyle.Rpc)]
    double Add(double a, double b);

    [OperationContract, DataContractFormat(Style = OperationFormatStyle.Document)]
    double Subtract(double a, double b);
}

<ServiceContract(), DataContractFormat(Style := OperationFormatStyle.Rpc)>  _
Interface ICalculator
    <OperationContract(), DataContractFormat(Style := OperationFormatStyle.Rpc)>  _
    Function Add(ByVal a As Double, ByVal b As Double) As Double 
    
    <OperationContract(), DataContractFormat(Style := OperationFormatStyle.Document)>  _
    Function Subtract(ByVal a As Double, ByVal b As Double) As Double 
End Interface

<ServiceContract(), DataContractFormat(Style := OperationFormatStyle.Rpc)>  _
Interface ICalculator
    <OperationContract(), DataContractFormat(Style := OperationFormatStyle.Rpc)>  _
    Function Add(ByVal a As Double, ByVal b As Double) As Double 
    
    <OperationContract(), DataContractFormat(Style := OperationFormatStyle.Document)>  _
    Function Subtract(ByVal a As Double, ByVal b As Double) As Double 
End Interface

Comentários

Esse atributo é semelhante ao XmlSerializerFormatAttribute atributo. Ambos os atributos podem ser aplicados a um método ou a uma classe.

Um método pode ter um dos dois atributos aplicados, mas não ambos. Qualquer operação que não tenha sido aplicada usará o atributo aplicado à classe que contém. Se a classe de contenção não tiver nenhum atributo aplicado, ele DataContractSerializer será usado.

A aplicação do atributo também faz com que um DataContractSerializerOperationBehavior seja criado em tempo de execução. O comportamento permite a personalização em tempo de execução do comportamento do serializador.

Construtores

DataContractFormatAttribute()

Inicializa uma nova instância da classe DataContractFormatAttribute.

Propriedades

Style	Obtém ou define o estilo SOAP dos dados serializados.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a