SoapDocumentMethodAttribute Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
SoapDocumentMethodAttribute Zastosowanie metody do metody określa, że komunikaty PROTOKOŁU SOAP do i z metody używają Document formatowania.
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 AttributePublic NotInheritable Class SoapDocumentMethodAttribute
Inherits Attribute- Dziedziczenie
- Atrybuty
Przykłady
Poniższy przykład kodu ustawia styl komunikatu na Document dla GetUserName metody usługi sieci Web XML. Ponadto element XML z elementem Body dla żądania SOAP i odpowiedzi SOAP są ustawione odpowiednio na GetUserNameRequest i GetUserNameResponse.
<%@ 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
Uwagi
Język opisu usług sieci Web (WSDL) definiuje dwa style sposobu, w jaki metoda usługi sieci Web XML, którą wywołuje operację, można sformatować w komunikacie PROTOKOŁU SOAP: RPC i Document.
Document odnosi się do formatowania metody usługi sieci Web XML zgodnie ze schematem XSD. Styl Document odnosi się do formatowania Body elementu jako serii co najmniej jednej części komunikatu po elemecie Body . Dokładnie w jaki sposób poszczególne części komunikatu Use są określane przez właściwości i ParameterStyle . Właściwość Use określa, czy parametry są sformatowane Encoded , czy Literal. Określa ParameterStyle , czy parametry są hermetyzowane w ramach pojedynczej części komunikatu po elemenie Body , czy każdy parametr jest pojedynczą częścią komunikatu.
Aby uzyskać więcej informacji, zobacz Dostosowywanie formatowania komunikatów PROTOKOŁU SOAP.
Ten atrybut można zastosować zarówno do metody usługi sieci Web XML na serwerze, jak i metody klasy serwera proxy na kliencie.
Konstruktory
| SoapDocumentMethodAttribute() |
Inicjuje nowe wystąpienie klasy SoapDocumentMethodAttribute. |
| SoapDocumentMethodAttribute(String) |
Inicjuje SoapDocumentMethodAttribute nowe wystąpienie klasy, ustawiając Action właściwość na wartość parametru |
Właściwości
| Action |
Pobiera lub ustawia |
| Binding |
Pobiera lub ustawia powiązanie metody usługi sieci Web XML implementuje operację . |
| OneWay |
Pobiera lub ustawia, czy klient usługi sieci Web XML czeka na zakończenie przetwarzania metody usługi sieci Web XML. |
| ParameterStyle |
Pobiera lub ustawia, czy parametry są hermetyzowane w ramach pojedynczego elementu XML pod elementem |
| RequestElementName |
Pobiera lub ustawia element XML skojarzony z żądaniem SOAP dla metody usługi sieci Web XML, która jest zdefiniowana w opisie usługi jako operacja. |
| RequestNamespace |
Pobiera lub ustawia przestrzeń nazw skojarzona z żądaniem PROTOKOŁU SOAP dla metody usługi sieci Web XML. |
| ResponseElementName |
Pobiera lub ustawia element XML skojarzony z odpowiedzią PROTOKOŁU SOAP dla metody usługi sieci Web XML. |
| ResponseNamespace |
Pobiera lub ustawia przestrzeń nazw XML skojarzona z odpowiedzią PROTOKOŁU SOAP dla metody usługi sieci Web XML. |
| TypeId |
Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute) |
| Use |
Pobiera lub ustawia formatowanie parametrów dla metody usługi sieci Web XML w części XML komunikatu PROTOKOŁU SOAP. |
Metody
| Equals(Object) |
Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute) |
| GetHashCode() |
Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| IsDefaultAttribute() |
Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute) |
| Match(Object) |
Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Jawne implementacje interfejsu
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu. (Odziedziczone po Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute) |
