SoapDocumentServiceAttribute Třída

Reference

Definice

Obor názvů:: System.Web.Services.Protocols

Sestavení:: System.Web.Services.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Použití volitelné SoapDocumentServiceAttribute webové služby XML nastaví výchozí formát požadavků a odpovědí SOAP 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: 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 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 pro formátování metody webové služby XML, která volá operaci, v požadavku SOAP nebo odpovědi SOAP: RPC a Document. Přesný způsob určení jednotlivých částí zprávy pomocí Use vlastností 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, která implementuje webovou službu XML.

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 rámci jednoho elementu XML, pod `Body` elementem, ve zprávách SOAP.

Vlastnosti

ParameterStyle	Získá nebo nastaví výchozí nastavení, které řídí, zda jsou parametry zapouzdřeny v jednom elementu za `<Body>` elementem xml část zprávy SOAP pro metody webové služby XML webové služby XML.
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 tuto Attributetřídu . (Zděděno od Attribute)
Use	Získá nebo nastaví výchozí formátování parametru webové služby XML.

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()	Type Získá z aktuální instance. (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