SoapRpcServiceAttribute-Klasse

Artikel
08/20/2007

Legt das Standardformat für SOAP-Anfragen 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 SoapRpcServiceAttribute
    Inherits Attribute
'Usage
Dim instance As SoapRpcServiceAttribute

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

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

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

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

Hinweise

Mit dem SoapRpcServiceAttribute können Sie den Standardcodierungsstil für XML-Webdienstmethoden innerhalb eines XML-Webdiensts auf RPC-Methodencodierung und Encoded-Parametercodierung festlegen.

WSDL (Web Services Description Language) definiert zwei Stile zum Codieren einer XML-Webdienstmethode (eines Vorgangs) in einer SOAP-Anfrage oder SOAP-Antwort: RPC und Document. Der RPC-Stil bezieht sich auf das Codieren der XML-Webdienstmethode laut Abschnitt 7 der SOAP-Spezifikation für die Verwendung von SOAP für RPC. Dieser Stil gibt an, dass alle Parameter in einem einzelnen nach der XML-Webdienstmethode benannten Element gekapselt werden und dass jedes Element innerhalb dieses Elements einen Parameter darstellt, der nach dem betreffenden Parameternamen benannt ist.

Um die Standardcodierung auf Methodenebene auf Document festzulegen, wenden Sie ein SoapDocumentServiceAttribute 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

Im folgenden Beispiel wird die Verwendung der SoapRpcServiceAttribute-Klasse veranschaulicht.

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

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

    <SoapRpcServiceAttribute(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;

    [SoapRpcService(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.SoapRpcServiceAttribute

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 Millennium Edition, 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

Siehe auch

Referenz

SoapRpcServiceAttribute-Member
System.Web.Services.Protocols-Namespace
SoapDocumentServiceAttribute-Klasse
SoapRpcMethodAttribute-Klasse
SoapBindingUse-Enumeration
SoapServiceRoutingStyle

Freigeben über