SoapHeaderDirection Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, является ли получатель SoapHeader веб-службой XML, клиентом веб-службы XML или обоими.
Это перечисление поддерживает побитовую комбинацию значений его членов.
public enum class SoapHeaderDirection
[System.Flags]
public enum SoapHeaderDirection
[<System.Flags>]
type SoapHeaderDirection =
Public Enum SoapHeaderDirection
- Наследование
- Атрибуты
Поля
Fault | 4 | Указывает SoapHeader отправляется клиенту веб-службы XML при возникновении исключения методом веб-службы XML. |
In | 1 | Указывает SoapHeader отправляется в веб-службу XML. |
InOut | 3 | Указывает SoapHeader отправляется как веб-службе XML, так и клиенту веб-службы XML. |
Out | 2 | Указывает SoapHeader отправляется клиенту веб-службы XML. |
Примеры
Следующий метод веб-службы XML указывает, что myHeader
SoapHeader отправляется из клиента веб-службы XML в веб-службу XML, а затем возвращается клиенту веб-службы XML независимо от исключения, возникающего во время выполнения метода веб-службы XML.
public ref class MyHeader: public SoapHeader
{
public:
String^ MyValue;
};
public ref class MyWebService
{
public:
MyHeader^ myHeader;
[WebMethod]
[SoapHeader("myHeader",
Direction=SoapHeaderDirection::InOut|SoapHeaderDirection::Fault)]
void MySoapHeaderReceivingMethod()
{
// Set myHeader->MyValue to some value.
}
};
public class MyHeader : SoapHeader {
public string MyValue;
}
public class MyWebService {
public MyHeader myHeader;
[WebMethod]
[SoapHeader("myHeader",
Direction=SoapHeaderDirection.InOut | SoapHeaderDirection.Fault)]
public void MySoapHeaderReceivingMethod() {
// Set myHeader.MyValue to some value.
}
}
Public Class MyHeader
Inherits SoapHeader
Public MyValue As String
End Class
Public Class MyWebService
Public myHeader As MyHeader
<WebMethod, _
SoapHeader("myHeader", _
Direction := SoapHeaderDirection.InOut Or SoapHeaderDirection.Fault)> _
Public Sub MySoapHeaderReceivingMethod()
' Set myHeader.MyValue to some value.
End Sub
End Class
Комментарии
SoapHeaderAttribute можно применить либо к методу веб-службы XML, либо к методу прокси-класса к веб-службе XML. В любом случае получатели задаются свойством SoapHeaderAttribute.Direction. Чтобы указать, что метод веб-службы XML возвращает заголовок SOAP при возникновении исключения во время его выполнения, примените SoapHeaderAttribute к методу и задайте для свойства SoapHeaderAttribute.Direction значение Fault
.