Exportieren (0) 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

SoapRpcMethodAttribute-Klasse

Gibt an, dass die an die Methode und von dieser gesendeten SOAP-Nachrichten RPC-Formatierung verwenden.

System.Object
  System.Attribute
    System.Web.Services.Protocols.SoapRpcMethodAttribute

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

[AttributeUsageAttribute(AttributeTargets.Method)]
public sealed class SoapRpcMethodAttribute : Attribute

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

  NameBeschreibung
Öffentliche MethodeSoapRpcMethodAttribute()Initialisiert eine neue Instanz der SoapRpcMethodAttribute-Klasse und legt alle Eigenschaften auf deren Standardwerte fest.
Öffentliche MethodeSoapRpcMethodAttribute(String)Initialisiert eine neue Instanz der SoapRpcMethodAttribute-Klasse und legt die Action-Eigenschaft auf den Wert des action-Parameters fest.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftActionRuft das SOAPAction-HTTP-Headerfeld der SOAP-Anforderung ab oder legt dieses fest.
Öffentliche EigenschaftBindingRuft den Namen einer Bindung ab, für die eine XML-Webdienstmethode einen Vorgang implementiert, oder legt diesen Namen fest.
Öffentliche EigenschaftOneWayRuft ab oder legt fest, ob ein XML-Webdienstclient darauf wartet, dass der Webserver die Verarbeitung einer XML-Webdienstmethode beendet.
Öffentliche EigenschaftRequestElementNameRuft das XML-Element ab, das der SOAP-Anforderung für eine XML-Webdienstmethode zugeordnet ist, oder legt dieses fest.
Öffentliche EigenschaftRequestNamespaceRuft den XML-Namespace ab, der der SOAP-Anforderung für eine XML-Webdienstmethode zugeordnet ist, oder legt diesen fest.
Öffentliche EigenschaftResponseElementNameRuft das XML-Element ab, das der SOAP-Antwort für eine XML-Webdienstmethode zugeordnet ist, oder legt dieses fest.
Öffentliche EigenschaftResponseNamespaceRuft den XML-Namespace ab, der der SOAP-Antwort für eine XML-Webdienstmethode zugeordnet ist, oder legt diesen fest.
Öffentliche EigenschaftTypeId Bei Implementierung in einer abgeleiteten Klasse wird ein eindeutiger Bezeichner für dieses Attribute abgerufen. (Von Attribute geerbt.)
Öffentliche EigenschaftUseRuft die beim Aufruf der Methode verwendete Bindung ab oder legt diese 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

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

Mit SOAP-Nachrichten, die im RPC-Format und im Document-Format formatiert sind, kann die Kommunikation mit einem XML-Webdienst über Remoteprozeduraufrufe (RPC) ausgeführt werden. Das Document-Format kann aber auch für die Kommunikation über lose Verknüpfungen verwendet werden. Aus diesem Grund wird das Document-Format für XML-Webdienste empfohlen. Weitere Informationen finden Sie unter dem Thema Customizing SOAP Messages.

Weitere Informationen finden Sie unter [<topic://cpconCustomizingSOAPInASPNETWebServicesWebServiceClients>].

Dieses Attribut kann sowohl für eine XML-Webdienstmethode auf dem Server als auch für eine Proxyklasse auf dem Client angewendet werden. XML-Webdienstmethoden, deren OneWay-Eigenschaft auf true festgelegt ist, können nicht auf ihren HttpContext zugreifen. Daher wird beim Zugriff auf diese Eigenschaften der WebService-Klasse null zurückgegeben.

Im folgenden Codebeispiel wird der Meldungsstil für die GetUserName-XML-Webdienstmethode auf Rpc festgelegt.


<%@ WebService Language="C#" class="MyUser" %>
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;

 public class MyUser : WebService {

       [ SoapRpcMethod(Action="http://www.contoso.com/Sample", 
           RequestNamespace="http://www.contoso.com/Request",
           RequestElementName="GetUserNameRequest",
           ResponseNamespace="http://www.contoso.com/Response",
           ResponseElementName="GetUserNameResponse")]
      [ WebMethod(Description="Obtains the User Name") ]
      public UserName GetUserName() {
           string temp;
           int pos;
           UserName NewUser = new UserName();

           // Get the full user name, including the domain name if applicable.
           temp = User.Identity.Name;

           // Determine whether the user is part of a domain by searching for a backslash.
           pos = temp.IndexOf("\\");

           // Parse out the domain name from the string, if one exists.
           if (pos <= 0)
                 NewUser.Name = User.Identity.Name;
           else {
               NewUser.Name = temp.Remove(0,pos+1);
                 NewUser.Domain = temp.Remove(pos,temp.Length-pos);
           } 
       return NewUser;
      }

 }   

 public class UserName {

     public string Name;
     public string Domain;
 }



.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:
© 2015 Microsoft