SoapDocumentServiceAttribute Klasse

Referenz

Definition

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

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

Vererbung: Object

Attribute
SoapDocumentServiceAttribute

Attribute: AttributeUsageAttribute

Beispiele

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

Hinweise

Mit SoapDocumentServiceAttribute können Sie die Standardformatierungsstile für XML-Webdienstmethoden innerhalb eines XML-Webdiensts festlegen. Wenn eine einzelne XML-Webdienstmethode diese Standardwerte ändern muss, wenden Sie eine SoapDocumentMethodAttribute auf diese XML-Webdienstmethode an.

Web Services Description Language (WSDL) definiert zwei Stile dafür, wie eine XML-Webdienstmethode, die einen Vorgang aufruft, in einer SOAP-Anforderung oder einer SOAP-Antwort formatiert werden kann: RPC und Document. Genau, wie die einzelnen Nachrichtenteile durch die Use Eigenschaften und ParameterStyle bestimmt werden. Die Use -Eigenschaft bestimmt, ob Parameter formatiert oder Literalformatiert Encoded sind. Bestimmt ParameterStyle , ob die Parameter in einem einzelnen Nachrichtenteil unterhalb des Body Elements gekapselt sind oder ob jeder Parameter ein einzelner Nachrichtenteil ist.

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

Weitere Informationen finden Sie unter Anpassen der SOAP-Nachrichtenformatierung.

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

Konstruktoren

SoapDocumentServiceAttribute()	Initialisiert eine neue Instanz der SoapDocumentServiceAttribute-Klasse und legt alle Eigenschaften auf deren Standardwerte fest.
SoapDocumentServiceAttribute(SoapBindingUse)	Initialisiert eine neue Instanz der SoapDocumentServiceAttribute-Klasse, die die Parameterformatierung festlegt.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)	Initialisiert eine neue Instanz der SoapDocumentServiceAttribute-Klasse, die die Parameterformatierung festlegt und außerdem bestimmt, ob Parameter innerhalb eines einzelnen XML-Elements unter dem `Body`-Element in SOAP-Nachrichten gekapselt sind.

Eigenschaften

ParameterStyle	Ruft die Standardeinstellung ab, die steuert, ob Parameter innerhalb eines einzigen Elements nach dem `<Body>`-Element im XML-Teil einer SOAP-Nachricht für XML-Webdienstmethoden des XML-Webdiensts gekapselt sind, oder legt diese fest.
RoutingStyle	Ruft ab oder legt fest, wie SOAP-Nachrichten an den XML-Webdienst weitergeleitet werden.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
Use	Ruft die Standardparameterformatierung für einen XML-Webdienst ab oder legt diesen fest.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für: