SoapDocumentMethodAttribute.Action Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает поле HTTP-заголовка SOAPAction
запроса SOAP.
public:
property System::String ^ Action { System::String ^ get(); void set(System::String ^ value); };
public string Action { get; set; }
member this.Action : string with get, set
Public Property Action As String
Значение свойства
Поле HTTP-заголовка SOAPAction
запроса SOAP. Значение по умолчанию — http://tempuri.org/MethodName
, где MethodName — это имя метода веб-службы XML.
Примеры
В следующем примере кода свойству присваивается Action значение http://www.contoso.com/GetUserName
.
<%@ WebService Language="C#" class="MyUser" %>
using System.Web.Services;
using System.Web.Services.Protocols;
public class MyUser : WebService {
[ SoapDocumentMethod(Action="http://www.contoso.com/GetUserName")]
public string GetUserName() {
return User.Identity.Name;
}
}
<%@ WebService Language="VB" class="MyUser" %>
Imports System.Web.Services
Imports System.Web.Services.Protocols
Public Class MyUser
Inherits WebService
<SoapDocumentMethod(Action := "http://www.contoso.com/GetUserName")> _
Public Function _
GetUserName() As String
Return User.Identity.Name
End Function
End Class
Комментарии
Как правило, Action свойство является универсальным кодом ресурса (URI), указывающим назначение запроса. Однако спецификация SOAP не накладывает ограничений на формат универсального кода ресурса (URI) или какие-либо правила, определяющие, является ли универсальный код ресурса (URI) разрешаемым. Наличие и содержимое Action свойства могут использоваться веб-серверами, такими как брандмауэры, для надлежащей фильтрации сообщений запросов SOAP по ПРОТОКОЛУ HTTP.
По умолчанию платформа .NET Framework версии 1.1 публикует Action свойство в soapAction
атрибуте soap:operation
элемента для каждой поддерживаемой привязки SOAP в документах WSDL, созданных для веб-службы XML. Дополнительные сведения см. в спецификации SOAP на веб-сайте W3C.