SoapIncludeAttribute Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
XmlSerializer Tillåter att en typ identifieras när den serialiserar eller deserialiserar ett objekt som kodad SOAP XML.
public ref class SoapIncludeAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
inherit Attribute[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
inherit AttributePublic Class SoapIncludeAttribute
Inherits Attribute- Arv
- Attribut
Exempel
Följande exempel gäller SoapIncludeAttribute två gånger för en XML-webbtjänstmetod. Metoden returnerar ett objekt av typen Vehicle (en basklass).
SoapIncludeAttribute Tillåter metoden att returnera instanser av klasser som härletts från Vehicle klassen.
Kommentarer
Klassen SoapIncludeAttribute tillhör en familj med attribut som styr hur XmlSerializer serialiserar, eller deserialiserar, ett objekt som kodad SOAP XML. Den resulterande XML-koden överensstämmer med avsnitt 5 i World Wide Web Consortium-dokumentet , SIMPLE Object Access Protocol (SOAP) 1.1. En fullständig lista över liknande attribut finns i Attribut som styr kodad SOAP-serialisering.
Om du vill serialisera ett objekt som ett kodat SOAP-meddelande måste du skapa XmlSerializer med hjälp av en XmlTypeMapping skapad med ImportTypeMapping -metoden för SoapReflectionImporter klassen.
När du tillämpar SoapIncludeAttributeanger du för Type den härledda klassen. XmlSerializer När serialiserar objekt som innehåller både basklasserna och de härledda klasserna kan de sedan känna igen båda objekttyperna.
Du kan använda SoapIncludeAttribute för att inkludera härledda klasser i tjänstbeskrivningsdokument som är skrivna i WSDL (Web Services Description Language). Om en metod till exempel returnerar en Objecttillämpar du SoapIncludeAttribute på -metoden och anger de faktiska typer som ska returneras.
Mer information om WSDL finns i World Wide Web Consortium specification, Web Services Description Language (WSDL) 1.1.
Mer information om hur du använder attribut finns i Attribut.
Konstruktorer
| Name | Description |
|---|---|
| SoapIncludeAttribute(Type) |
Initierar en ny instans av SoapIncludeAttribute klassen med den angivna typen. |
Egenskaper
| Name | Description |
|---|---|
| Type |
Hämtar eller anger vilken typ av objekt som ska användas när ett objekt serialiseras eller deserialiseras. |
| TypeId |
När den implementeras i en härledd klass hämtar du en unik identifierare för den här Attribute. (Ärvd från Attribute) |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Returnerar ett värde som anger om den här instansen är lika med ett angivet objekt. (Ärvd från Attribute) |
| GetHashCode() |
Returnerar hash-koden för den här instansen. (Ärvd från Attribute) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| IsDefaultAttribute() |
När den åsidosättas i en härledd klass anger du om värdet för den här instansen är standardvärdet för den härledda klassen. (Ärvd från Attribute) |
| Match(Object) |
När den åsidosätts i en härledd klass returneras ett värde som anger om den här instansen är lika med ett angivet objekt. (Ärvd från Attribute) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappar en uppsättning namn till en motsvarande uppsättning av sändningsidentifierare. (Ärvd från Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Hämtar typinformationen för ett objekt, som kan användas för att hämta typinformationen för ett gränssnitt. (Ärvd från Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Hämtar antalet typinformationsgränssnitt som ett objekt tillhandahåller (antingen 0 eller 1). (Ärvd från Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Ger åtkomst till egenskaper och metoder som exponeras av ett objekt. (Ärvd från Attribute) |
