Sdílet prostřednictvím

SoapDocumentServiceAttribute Třída

Definice

Obor názvů:
System.Web.Services.Protocols
Sestavení:
System.Web.Services.dll

Použití volitelné SoapDocumentServiceAttribute ve webové službě XML nastaví výchozí formát požadavků SOAP a odpovědí odeslaných do a z metod webové služby XML ve webové službě XML.

public ref class SoapDocumentServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class)>]
type SoapDocumentServiceAttribute = class
    inherit Attribute
Public NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute
Dědičnost
Object
Attribute
SoapDocumentServiceAttribute
Atributy
AttributeUsageAttribute

Příklady

<%@ WebService Language="c#" Class="SumService" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;

    [SoapDocumentService(SoapBindingUse.Literal,
                         SoapParameterStyle.Wrapped,
                         RoutingStyle=SoapServiceRoutingStyle.SoapAction)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int a, int b)
        {
            return a + b;
        }
    }

<%@ WebService Language="VB" Class="SumService" %>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description

    <SoapDocumentService(SoapBindingUse.Literal, _
                             SoapParameterStyle.Wrapped, _
                             RoutingStyle := SoapServiceRoutingStyle.SoapAction)> _
    Public Class SumService 
          Inherits System.Web.Services.WebService
    
        <WebMethod> _
        Public Function Add(a As Integer, b as Integer)
           return a + b
        End Function
    End Class

Poznámky

Umožňuje SoapDocumentServiceAttribute nastavit výchozí styly formátování pro metody webové služby XML ve webové službě XML. Pokud jednotlivá metoda webové služby XML musí změnit tyto výchozí hodnoty, použijte pro tuto metodu SoapDocumentMethodAttribute webové služby XML.

Jazyk WSDL (Web Services Description Language) definuje dva styly pro způsob, jakým metoda webové služby XML, která volá operaci, lze formátovat v požadavku SOAP nebo v odpovědi SOAP: RPC a Document. Přesně to, jak jednotlivé části zprávy určují Use vlastnosti a ParameterStyle vlastnosti. Vlastnost Use určuje, zda jsou parametry formátovány Encoded nebo Literal. Určuje ParameterStyle , zda jsou parametry zapouzdřeny v rámci jedné části zprávy pod Body elementem, nebo zda je každý parametr jednotlivé části zprávy.

Chcete-li nastavit výchozí formátování RPCna úrovni metody , použijte SoapRpcServiceAttribute u třídy implementující webovou službu XML.

Další podrobnosti najdete v tématu Přizpůsobení formátování zpráv SOAP.

Tento atribut lze použít u třídy, která implementuje webovou službu XML.

Konstruktory

Name Description
SoapDocumentServiceAttribute()

Inicializuje novou instanci SoapDocumentServiceAttribute třídy nastavení všech vlastností na jejich výchozí hodnoty.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

Inicializuje novou instanci SoapDocumentServiceAttribute třídy, která nastaví formátování parametrů a nastaví, zda jsou parametry zapouzdřeny v rámci jednoho elementu XML pod Body elementem ve zprávách SOAP.
SoapDocumentServiceAttribute(SoapBindingUse)

Inicializuje novou instanci SoapDocumentServiceAttribute třídy nastavení formátování parametru.

Vlastnosti

Name Description
ParameterStyle

Získá nebo nastaví výchozí nastavení, které řídí, zda parametry jsou zapouzdřeny v rámci jednoho elementu <Body> za elementem v xml části zprávy SOAP zprávy XML webové služby metody XML webové služby.
RoutingStyle

Získá nebo nastaví, jak jsou zprávy SOAP směrovány do webové služby XML.
TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute.

(Zděděno od Attribute)
Use

Získá nebo nastaví výchozí formátování parametrů pro webovou službu XML.

Metody

Name Description
Equals(Object)

Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu.

(Zděděno od Attribute)
GetHashCode()

Vrátí kód hash pro tuto instanci.

(Zděděno od Attribute)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
IsDefaultAttribute()

Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu.

(Zděděno od Attribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

Name Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.

(Zděděno od Attribute)

Platí pro

Viz také