SoapFieldAttribute Classe

Définition

Espace de noms:

System.Runtime.Remoting.Metadata

Assembly:

mscorlib.dll

Personnalise la génération et le traitement SOAP pour un champ. Cette classe ne peut pas être héritée.

public ref class SoapFieldAttribute sealed : 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)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapFieldAttribute = class
    inherit SoapAttribute

Public NotInheritable Class SoapFieldAttribute
Inherits SoapAttribute

Héritage

Object

Attribute

SoapAttribute

SoapFieldAttribute

Attributs

AttributeUsageAttribute ComVisibleAttribute

Exemples

L’exemple de code suivant illustre la personnalisation de SOAP générée pour un champ d’une classe avec le SoapFieldAttribute. Le soap peut être produit par le code indiqué dans l’exemple 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

Remarques

Les objets cibles de l’attribut SoapFieldAttribute sont des champs d’objet. L’attribut SoapFieldAttribute est utilisé pour spécifier des informations qui contrôlent la façon dont le .NET Framework génère le format de liaison XML SOAP pour les champs cibles.

Constructeurs

SoapFieldAttribute()

Crée une instance d'une classe SoapFieldAttribute.

Champs

ProtXmlNamespace	Espace de noms XML dans lequel la cible de l'attribut SOAP actuel est sérialisée. (Hérité de SoapAttribute)
ReflectInfo	Objet de réflexion utilisé par les classes d'attributs dérivées de la classe SoapAttribute pour définir les informations de sérialisation XML. (Hérité de SoapAttribute)

Propriétés

Embedded	Obtient ou définit une valeur indiquant si le type doit être imbriqué lors de la sérialisation SOAP. (Hérité de SoapAttribute)
Order	Obtient ou définit la commande de l'attribut de champ actuel.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
UseAttribute	Obtient ou définit une valeur indiquant si la cible de l'attribut actuel est sérialisée en tant qu'attribut XML au lieu de l'être en tant que champ XML. (Hérité de SoapAttribute)
XmlElementName	Obtient ou définit le nom d'élément XML du champ contenu dans l'attribut SoapFieldAttribute.
XmlNamespace	Obtient ou définit le nom de l'espace de noms XML. (Hérité de SoapAttribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
IsInteropXmlElement()	Retourne une valeur indiquant si l'attribut actuel contient des valeurs d'élément XML Interop.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)