SoapDocumentServiceAttribute Třída

Definice

Použití volitelné SoapDocumentServiceAttribute webové služby XML nastaví výchozí formát požadavků SOAP a odpovědí odesílaných do a z metod webové služby XML v rámci webové služby 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
SoapDocumentServiceAttribute
Atributy

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 v rámci webové služby XML. Pokud jednotlivá metoda webové služby XML musí změnit tyto výchozí hodnoty, použijte na tuto metodu SoapDocumentMethodAttribute webové služby XML.

WsDL (Web Services Description Language) definuje dva styly, jak lze formátovat metodu webové služby XML, kterou volá operaci, v požadavku SOAP nebo v odpovědi SOAP: RPC a Document. Přesně to, jak jsou jednotlivé části zprávy určeny vlastnostmi Use a ParameterStyle Vlastnost Use určuje, jestli jsou parametry formátované Encoded nebo Literal. Určuje ParameterStyle , zda jsou parametry zapouzdřeny v jedné části zprávy pod elementem Body , nebo zda je každý parametr samostatnou částí zprávy.

Chcete-li nastavit výchozí formátování na úrovni metody na RPC, použijte SoapRpcServiceAttribute na třídu 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 na třídu implementují xml webovou službu.

Konstruktory

SoapDocumentServiceAttribute()

Inicializuje novou instanci SoapDocumentServiceAttribute třídy nastavení všech vlastností na jejich výchozí hodnoty.

SoapDocumentServiceAttribute(SoapBindingUse)

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

SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

Inicializuje novou instanci SoapDocumentServiceAttribute třídy, která nastaví formátování parametru a nastaví, zda jsou parametry zapouzdřeny v jednom elementu XML, pod Body elementem, ve zprávách SOAP.

Vlastnosti

ParameterStyle

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

RoutingStyle

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

TypeId

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

(Zděděno od Attribute)
Use

Získá nebo nastaví výchozí formátování parametru pro xml webové služby.

Metody

Equals(Object)

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

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

Vrátí hodnotu hash pro tuto instanci.

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

Získá aktuální Type instanci.

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

Při přepsání v odvozené třídě označuje, zda je hodnota této instance 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á označuje, zda se tato instance rovná zadanému objektu.

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

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

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

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

(Zděděno od Object)

Explicitní implementace rozhraní

_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é