SoapDocumentServiceAttribute Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Services.Protocols

Zestaw:: System.Web.Services.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zastosowanie opcjonalnej SoapDocumentServiceAttribute do usługi sieci Web XML ustawia domyślny format żądań PROTOKOŁU SOAP i odpowiedzi wysyłanych do i z metod usługi sieci Web XML w usłudze sieci Web 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

Dziedziczenie: Object

Attribute
SoapDocumentServiceAttribute

Atrybuty: AttributeUsageAttribute

Przykłady

<%@ 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

Uwagi

Umożliwia SoapDocumentServiceAttribute ustawienie domyślnych stylów formatowania dla metod usługi sieci Web XML w usłudze sieci Web XML. Jeśli pojedyncza metoda usługi sieci Web XML musi zmienić te wartości domyślne, zastosuj SoapDocumentMethodAttribute do tej metody usługi sieci Web XML.

Język opisu usług sieci Web (WSDL) definiuje dwa style sposobu, w jaki metoda usługi sieci Web XML, którą wywołuje operację, można sformatować w żądaniu SOAP lub odpowiedzi PROTOKOŁU SOAP: RPC i Document. Dokładnie sposób określania poszczególnych części komunikatów Use przez właściwości i ParameterStyle . Właściwość Use określa, czy parametry są sformatowane Encoded , czy Literal. Określa ParameterStyle , czy parametry są hermetyzowane w ramach jednej części komunikatu Body poniżej elementu, czy też każdy parametr jest pojedynczą częścią komunikatu.

Aby ustawić domyślne formatowanie na poziomie metody na RPC, zastosuj SoapRpcServiceAttribute element do klasy implementujące usługę sieci Web XML.

Aby uzyskać więcej informacji, zobacz Dostosowywanie formatowania komunikatów PROTOKOŁU SOAP.

Ten atrybut można zastosować do klasy implementowania usługi sieci Web XML.

Konstruktory

SoapDocumentServiceAttribute()	Inicjuje SoapDocumentServiceAttribute nowe wystąpienie klasy ustawiając wszystkie właściwości na wartości domyślne.
SoapDocumentServiceAttribute(SoapBindingUse)	Inicjuje SoapDocumentServiceAttribute nowe wystąpienie klasy ustawiające formatowanie parametru.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)	Inicjuje SoapDocumentServiceAttribute nowe wystąpienie klasy, które ustawia formatowanie parametrów i ustawia, czy parametry są hermetyzowane w ramach jednego elementu XML w `Body` obszarze elementu w komunikatach SOAP.

Właściwości

ParameterStyle	Pobiera lub ustawia ustawienie domyślne, które określa, czy parametry są hermetyzowane w ramach jednego elementu po `<Body>` elemecie w części XML komunikatu SOAP dla metod usługi sieci Web XML usługi sieci Web XML.
RoutingStyle	Pobiera lub ustawia sposób kierowania komunikatów PROTOKOŁU SOAP do usługi sieci Web XML.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)
Use	Pobiera lub ustawia domyślne formatowanie parametrów dla usługi sieci Web XML.

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie obiektu, którego można użyć do pobrania informacji o typie interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)

Dotyczy