SoapHeaderDirection 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
指定 SoapHeader 的收件者是 XML Web 服務、XML Web 服務客戶端,還是兩者。
此列舉支援其成員值的位元組合。
public enum class SoapHeaderDirection
[System.Flags]
public enum SoapHeaderDirection
[<System.Flags>]
type SoapHeaderDirection =
Public Enum SoapHeaderDirection
- 繼承
- 屬性
欄位
Fault | 4 | 指定當 XML Web 服務方法擲回例外狀況時,SoapHeader 傳送至 XML Web 服務用戶端。 |
In | 1 | 指定 SoapHeader 傳送至 XML Web 服務。 |
InOut | 3 | 指定 SoapHeader 會同時傳送至 XML Web 服務和 XML Web 服務用戶端。 |
Out | 2 | 指定 SoapHeader 傳送至 XML Web 服務用戶端。 |
範例
下列 XML Web 服務方法會指定 myHeader
SoapHeader 會從 XML Web 服務用戶端傳送至 XML Web 服務,然後回到 XML Web 服務用戶端,而不論 XML Web 服務方法執行期間擲回的例外狀況為何。
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 Web 服務方法或 Proxy 類別的方法至 XML Web 服務。 不論是哪一種情況,收件者都是由 SoapHeaderAttribute.Direction 屬性所指定。 若要指定 XML Web 服務方法在執行期間擲回例外狀況時,傳回 SOAP 標頭,請將 SoapHeaderAttribute 套用至 方法,並將 SoapHeaderAttribute.Direction 屬性設定為 Fault
。