SoapDocumentMethodAttribute 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.

Menerapkan ke SoapDocumentMethodAttribute metode menentukan bahwa pesan SOAP ke dan dari metode menggunakan Document pemformatan.

public ref class SoapDocumentMethodAttribute sealed : Attribute

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

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

Public NotInheritable Class SoapDocumentMethodAttribute
Inherits Attribute

Warisan: Object

Attribute
SoapDocumentMethodAttribute

Atribut: AttributeUsageAttribute

Contoh

Contoh kode berikut mengatur gaya pesan ke Document untuk GetUserName metode layanan Web XML. Selain itu, elemen XML dengan Body elemen untuk permintaan SOAP dan respons SOAP diatur ke GetUserNameRequest dan GetUserNameResponse, masing-masing.

<%@ WebService Language="C#" class="MyUser" %>
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class MyUser : WebService {
 
       [ SoapDocumentMethod(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 the domain name out of 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    
    
    <SoapDocumentMethod(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 the domain name out of 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 untuk bagaimana metode layanan Web XML, yang disebut operasi, dapat diformat dalam pesan SOAP: RPC dan Document. Document mengacu pada pemformatan metode layanan Web XML sesuai dengan skema XSD. Gaya Document mengacu pada pemformatan Body elemen sebagai serangkaian satu atau beberapa bagian pesan mengikuti Body elemen . Persis bagaimana bagian pesan individual ditentukan oleh Use properti dan ParameterStyle . Properti Use menentukan apakah parameter diformat Encoded atau Literal. ParameterStyle menentukan apakah parameter dienkapsulasi dalam satu bagian pesan mengikuti Body elemen atau apakah setiap parameter adalah bagian pesan individual.

Untuk detail selengkapnya, lihat Menyesuaikan Pemformatan Pesan SOAP.

Atribut ini dapat diterapkan ke metode layanan Web XML di server dan metode kelas proksi pada klien.

Konstruktor

SoapDocumentMethodAttribute()	Menginisialisasi instans baru kelas SoapDocumentMethodAttribute.
SoapDocumentMethodAttribute(String)	Menginisialisasi instans SoapDocumentMethodAttribute 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 metode layanan Web XML mengimplementasikan operasi untuk.
OneWay	Mendapatkan atau mengatur apakah klien layanan Web XML menunggu server Web selesai memproses metode layanan Web XML.
ParameterStyle	Mendapatkan atau mengatur apakah parameter dienkapsulasi dalam satu elemen XML di bawah `Body` elemen di bagian XML dari pesan SOAP.
RequestElementName	Mendapatkan atau mengatur elemen XML yang terkait dengan permintaan SOAP untuk metode layanan Web XML, yang didefinisikan dalam deskripsi layanan sebagai operasi.
RequestNamespace	Mendapatkan atau mengatur namespace 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 pemformatan parameter untuk metode layanan Web XML dalam bagian XML dari pesan SOAP.

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 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 yang 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