SoapRpcMethodAttribute Kelas

Referensi

Definisi

Ruang nama:: System.Web.Services.Protocols

Rakitan:: System.Web.Services.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan bahwa pesan SOAP yang dikirim ke dan dari metode menggunakan RPC pemformatan.

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

Warisan: Object

Attribute
SoapRpcMethodAttribute

Atribut: AttributeUsageAttribute

Contoh

Contoh kode berikut mengatur gaya pesan ke Rpc untuk GetUserName metode layanan Web XML.

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

Keterangan

Web Services Description Language (WSDL) mendefinisikan dua gaya tentang bagaimana metode layanan Web XML, atau operasi, dapat diformat dalam pesan SOAP: RPC dan Document. RPC pemformatan mengacu pada pemformatan operasi sesuai dengan spesifikasi SOAP untuk menggunakan SOAP untuk RPC; atau dikenal sebagai Bagian 7 dari spesifikasi SOAP. RPC pemformatan menyatakan bahwa semua parameter dienkapsulasi dalam satu elemen XML yang dinamai sesuai metode layanan Web XML dan bahwa setiap elemen XML dalam elemen XML tersebut mewakili parameter bernama setelah parameter yang diwakilinya.

Pesan SOAP yang diformat dalam RPC gaya dan Document dapat digunakan untuk berkomunikasi dengan layanan Web XML dengan cara Panggilan Prosedur Jarak Jauh (RPC) ; namun Document gaya juga dapat dengan mudah digunakan untuk berkomunikasi dengan cara yang digabungkan secara longgar. Oleh karena itu, Document layanan Web XML gaya disarankan. Untuk detail selengkapnya, lihat topiknya Customizing SOAP Messages .

Untuk detail selengkapnya, lihat Menyesuaikan Pemformatan Pesan SOAP.

Atribut ini dapat diterapkan ke metode layanan Web XML di server dan kelas proksi pada klien. Metode layanan Web XML yang memiliki properti yang OneWay diatur ke true tidak memiliki akses ke mereka HttpContext. Dengan demikian, mengakses salah satu properti pengembalian WebService kelas null.

Konstruktor

SoapRpcMethodAttribute()	Menginisialisasi instans SoapRpcMethodAttribute baru kelas, mengatur semua properti ke nilai defaultnya.
SoapRpcMethodAttribute(String)	Menginisialisasi instans SoapRpcMethodAttribute baru kelas, mengatur Action properti ke nilai `action` parameter.

Properti

Action	Mendapatkan atau mengatur `SOAPAction` bidang header HTTP dari permintaan SOAP.
Binding	Mendapatkan atau mengatur pengikatan yang diimplementasikan oleh metode layanan Web XML.
OneWay	Mendapatkan atau mengatur apakah klien layanan Web XML menunggu server Web selesai memproses metode layanan Web XML.
RequestElementName	Mendapatkan atau mengatur elemen XML yang terkait dengan permintaan SOAP untuk metode layanan Web XML.
RequestNamespace	Mendapatkan atau mengatur namespace XML yang terkait dengan permintaan SOAP untuk metode layanan Web XML.
ResponseElementName	Mendapatkan atau mengatur elemen XML yang terkait dengan respons SOAP untuk metode layanan Web XML.
ResponseNamespace	Mendapatkan atau mengatur namespace XML yang terkait dengan respons SOAP untuk metode layanan Web XML.
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)
Use	Mendapatkan atau mengatur pengikatan yang digunakan saat memanggil metode .

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Memetakan sekumpulan nama ke sekumpulan pengidentifikasi pengiriman yang sesuai. (Diperoleh dari Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Mengambil informasi jenis untuk objek, yang dapat digunakan untuk mendapatkan informasi jenis untuk antarmuka. (Diperoleh dari Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Mengambil jumlah antarmuka informasi jenis yang disediakan objek (baik 0 atau 1). (Diperoleh dari Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Menyediakan akses ke properti dan metode yang diekspos oleh objek. (Diperoleh dari Attribute)

Berlaku untuk

Bagikan melalui