SoapFieldAttribute Classe

Referência

Definição

Namespace:: System.Runtime.Remoting.Metadata

Assembly:: mscorlib.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.

Personaliza a geração de SOAP e processamento para um campo. Essa classe não pode ser herdada.

public ref class SoapFieldAttribute sealed : System::Runtime::Remoting::Metadata::SoapAttribute

[System.AttributeUsage(System.AttributeTargets.Field)]
public sealed class SoapFieldAttribute : System.Runtime.Remoting.Metadata.SoapAttribute

[System.AttributeUsage(System.AttributeTargets.Field)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SoapFieldAttribute : System.Runtime.Remoting.Metadata.SoapAttribute

[<System.AttributeUsage(System.AttributeTargets.Field)>]
type SoapFieldAttribute = class
    inherit SoapAttribute

[<System.AttributeUsage(System.AttributeTargets.Field)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapFieldAttribute = class
    inherit SoapAttribute

Public NotInheritable Class SoapFieldAttribute
Inherits SoapAttribute

Herança: Object

Attribute

SoapAttribute
SoapFieldAttribute

Atributos: AttributeUsageAttribute ComVisibleAttribute

Exemplos

O exemplo de código a seguir demonstra a personalização do SOAP gerado para um campo de uma classe com o SoapFieldAttribute. O SOAP pode ser produzido pelo código mostrado no exemplo de SerializableAttribute classe.

[Serializable]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public ref class TestSimpleObject
{
public:
   int member1;

   [SoapFieldAttribute(XmlElementName="MyXmlElement")] String^ member2;

   String^ member3;
   double member4;

   // A field that is not serialized.

   [NonSerialized] String^ member5;

   TestSimpleObject()
   {
      member1 = 11;
      member2 = "hello";
      member3 = "hello";
      member4 = 3.14159265;
      member5 = "hello world!";
   }
};

[Serializable()]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public class TestSimpleObject  {

    public int member1;

    [SoapFieldAttribute(XmlElementName="MyXmlElement")] public string member2;

    public string member3;
    public double member4;

    // A field that is not serialized.
    [NonSerialized()] public string member5;

    public TestSimpleObject() {

        member1 = 11;
        member2 = "hello";
        member3 = "hello";
        member4 = 3.14159265;
        member5 = "hello world!";
    }
}

<Serializable(), SoapTypeAttribute(XmlNamespace := "MyXmlNamespace")> Public Class TestSimpleObject
   
   Public member1 As Integer

   <SoapFieldAttribute(XmlElementName := "MyXmlElement")> Public member2 As String
   
   Public member3 As String
   Public member4 As Double

   ' A field that is not serialized.
   <NonSerialized()> Public member5 As String  


   Public Sub New()
      member1 = 11
      member2 = "hello"
      member3 = "hello"
      member4 = 3.14159265
      member5 = "hello world!"
   End Sub

End Class

Comentários

Os objetos de destino para o SoapFieldAttribute atributo são campos de objeto. O SoapFieldAttribute atributo é usado para especificar informações que controlam como o .NET Framework gera o formato de fio SOAP XML para campos de destino.

Construtores

SoapFieldAttribute()

Cria uma instância da classe SoapFieldAttribute.

Campos

ProtXmlNamespace	O namespace de XML para o qual o destino do atributo SOAP atual é serializado. (Herdado de SoapAttribute)
ReflectInfo	Um objeto de reflexão usado pelas classes de atributos derivados da classe SoapAttribute para definir as informações de serialização de XML. (Herdado de SoapAttribute)

Propriedades

Embedded	Obtém ou define um valor que indica se o tipo deve ser aninhado durante a serialização de SOAP. (Herdado de SoapAttribute)
Order	Obtém ou define a ordem do atributo de campo atual.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)
UseAttribute	Obtém ou define um valor que indica se o destino do atributo atual será serializado como um atributo XML em vez de um campo XML. (Herdado de SoapAttribute)
XmlElementName	Obtém ou define o nome do elemento XML do campo contido no atributo SoapFieldAttribute.
XmlNamespace	Obtém ou define o nome do namespace de XML. (Herdado de SoapAttribute)

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)
IsInteropXmlElement()	Retorna um valor que indica se o atributo atual contém valores de elemento XML de interoperabilidade.
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

Partilhar via