SoapRpcMethodAttribute クラス

定義

public ref class SoapRpcMethodAttribute sealed : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type SoapRpcMethodAttribute = class
    inherit Attribute

Public NotInheritable Class SoapRpcMethodAttribute
Inherits Attribute

継承

Object

Attribute

SoapRpcMethodAttribute

属性

AttributeUsageAttribute

例

次のコード例では、XML Web サービス メソッドのメッセージ スタイルを にRpcGetUserName設定します。

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

<%@ WebService Language="VB" class="MyUser" %>
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

Public Class MyUser
    Inherits 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 Function _
        GetUserName() As UserName
        
        Dim temp As String
        Dim pos As Integer
        Dim NewUser As 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 Then
            NewUser.Name = User.Identity.Name
        Else
            NewUser.Name = temp.Remove(0, pos + 1)
            NewUser.Domain = temp.Remove(pos, temp.Length - pos)
        End If
        Return NewUser
    End Function
End Class 

Public Class UserName
    
    Public Name As String
    Public Domain As String
End Class

注釈

Web サービス記述言語 (WSDL) は、XML Web サービス メソッド (または操作) を SOAP メッセージ RPC で書式設定する方法として、 と Documentの 2 つのスタイルを定義します。 RPC 書式設定とは、SOAP for RPC を使用するための SOAP 仕様に従って操作を書式設定することを指します。それ以外の場合は、SOAP 仕様のセクション 7 と呼ばれます。 RPC 書式設定では、すべてのパラメーターが XML Web サービス メソッドの名前の付いた 1 つの XML 要素内にカプセル化され、その XML 要素内の各 XML 要素が、その XML 要素が表すパラメーターにちなんだパラメーターを表していることを示します。

スタイルと Document スタイルの両方RPCで書式設定された SOAP メッセージは、リモート プロシージャ コール (RPC) 方式で XML Web サービスと通信するために使用できますがDocument、スタイルを使用して疎結合方式で簡単に通信することもできます。 そのため、 Document スタイル XML Web サービスをお勧めします。 詳細については、トピックを Customizing SOAP Messages 参照してください。

詳細については、「 SOAP メッセージの書式設定のカスタマイズ」を参照してください。

この属性は、サーバー上の XML Web サービス メソッドとクライアント上のプロキシ クラスに適用できます。 プロパティが に設定されている OneWay XML Web サービス メソッドは、 にtrueHttpContextアクセスできません。 そのため、 クラスのいずれかのプロパティにアクセスすると、 が WebService 返されます null。

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

適用対象

こちらもご覧ください

• SoapDocumentMethodAttribute
• SoapRpcServiceAttribute
• SoapDocumentServiceAttribute