SoapDocumentServiceAttribute-Klasse

Das Anwenden des optionalen SoapDocumentServiceAttribute auf einen XML-Webdienst legt das Standardformat von SOAP-Anforderungen und -Antworten fest, die an und von XML-Webdienstmethoden innerhalb des XML-Webdiensts gesendet werden.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Class)> _
Public NotInheritable Class SoapDocumentServiceAttribute
    Inherits Attribute
'Usage
Dim instance As SoapDocumentServiceAttribute

[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class SoapDocumentServiceAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class)] 
public ref class SoapDocumentServiceAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class SoapDocumentServiceAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Class) 
public final class SoapDocumentServiceAttribute extends Attribute

Hinweise

Mit dem SoapDocumentServiceAttribute können Sie Standardformatierungsstile für XML-Webdienstmethoden innerhalb eines XML-Webdiensts festlegen. Wenn diese Standardeinstellungen von einer XML-Webdienstmethode geändert werden müssen, wenden Sie ein SoapDocumentMethodAttribute auf diese XML-Webdienstmethode an.

WSDL (Web Services Description Language) definiert zwei Stile für das Formatieren einer auch als Vorgang bezeichneten XML-Webdienstmethode in einer SOAP-Anforderung oder einer SOAP-Antwort: RPC und Document. Wie genau die jeweilige Nachricht aufgeteilt wird, wird durch die Use-Eigenschaft und die ParameterStyle-Eigenschaft bestimmt. Die Use-Eigenschaft bestimmt, ob Parameter als Encoded oder als Literal formatiert werden. Der ParameterStyle bestimmt, ob die Parameter in einem Nachrichtenteil unter dem Body-Element eingekapselt sind oder ob jeder Parameter einen eigenen Nachrichtenteil darstellt.

Um die Standardformatierung auf Methodenebene auf RPC festzulegen, wenden Sie ein SoapRpcServiceAttribute auf die Klasse an, die den XML-Webdienst implementiert.

Weitere Informationen finden Sie unter Anpassen der Formatierung von SOAP-Nachrichten.

Dieses Attribut kann auf eine Klasse angewendet werden, die einen XML-Webdienst implementiert.

Beispiel

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

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

Vererbungshierarchie

System.Object
   System.Attribute
    System.Web.Services.Protocols.SoapDocumentServiceAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapDocumentServiceAttribute-Member
System.Web.Services.Protocols-Namespace
SoapDocumentMethodAttribute-Klasse
SoapRpcServiceAttribute

Weitere Ressourcen

Anpassen der Formatierung von SOAP-Nachrichten