(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

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.

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

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

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

Der SoapDocumentServiceAttribute-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeSoapDocumentServiceAttribute()Initialisiert eine neue Instanz der SoapDocumentServiceAttribute-Klasse und legt alle Eigenschaften auf deren Standardwerte fest.
Öffentliche MethodeSoapDocumentServiceAttribute(SoapBindingUse)Initialisiert eine neue Instanz der SoapDocumentServiceAttribute-Klasse, die die Parameterformatierung festlegt.
Öffentliche MethodeSoapDocumentServiceAttribute(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.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftParameterStyleRuft 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.
Öffentliche EigenschaftRoutingStyleRuft ab oder legt fest, wie SOAP-Nachrichten an den XML-Webdienst weitergeleitet werden.
Öffentliche EigenschaftTypeIdBei Implementierung in einer abgeleiteten Klasse wird ein eindeutiger Bezeichner für dieses Attribute abgerufen. (Von Attribute geerbt.)
Öffentliche EigenschaftUseRuft die Standardparameterformatierung für einen XML-Webdienst ab oder legt diesen fest.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEqualsInfrastruktur. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Von Attribute geerbt.)
Öffentliche MethodeGetHashCodeGibt den Hashcode für diese Instanz zurück. (Von Attribute geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIsDefaultAttributeBeim Überschreiben in einer abgeleiteten Klasse wird angegeben, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Von Attribute geerbt.)
Öffentliche MethodeMatchBeim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Von Attribute geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetIDsOfNamesOrdnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoRuft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoCountRuft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.InvokeStellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Von Attribute geerbt.)
Zum Seitenanfang

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 gekapselt 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 [<topic://cpconCustomizingSOAPInASPNETWebServicesWebServiceClients>].

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


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


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

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

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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft