SoapHeaderException 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
服务器错误的 SOAP 表示形式。
public ref class SoapHeaderException : System::Web::Services::Protocols::SoapExceptionpublic class SoapHeaderException : System.Web.Services.Protocols.SoapException[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapExceptiontype SoapHeaderException = class
inherit SoapException[<System.Serializable>]
type SoapHeaderException = class
inherit SoapExceptionPublic Class SoapHeaderException
Inherits SoapException- 继承
- 属性
示例
在下面的示例中，XML Web 服务客户端调用 MyWebMethod XML Web 服务方法，传入属性设置为true的 SOAP 标头MyHeaderMustUnderstand。 如果 XML Web 服务方法未将 DidUnderstand SOAP 标头的属性 MyHeader 设置为 true，则会引发 a SoapHeaderException 。
int main()
{
MyWebService^ ws = gcnew MyWebService;
try
{
MyHeader^ customHeader = gcnew MyHeader;
customHeader->MyValue = "Header Value for MyValue";
customHeader->MustUnderstand = true;
ws->myHeader = customHeader;
int results = ws->MyWebMethod( 3, 5 );
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception: {0}", e );
}
}
using System;
public class Sample {
public static void Main() {
MyWebService ws = new MyWebService();
try {
MyHeader customHeader = new MyHeader();
customHeader.MyValue = "Header Value for MyValue";
customHeader.MustUnderstand = true;
ws.myHeader = customHeader;
int results = ws.MyWebMethod(3,5);
}
catch (Exception e) {
Console.WriteLine ("Exception: {0}", e.ToString());
}
}
}
Public Class Sample
Public Shared Sub Main()
Dim ws As New MyWebService()
Try
Dim customHeader As New MyHeader1()
customHeader.MyValue = "Header Value for MyValue"
customHeader.MustUnderstand = True
ws.myHeader = customHeader
Dim results As Integer
results = ws.MyWebMethod(3,5)
Catch e As Exception
Console.WriteLine("Exception: {0}", e.ToString())
End Try
End Sub
End Class
注解
当 XML Web 服务客户端将 SOAP 标头添加到 XML Web 服务方法调用时，该MustUnderstand属性设置为 true否则，将trueDidUnderstand引发 XML SoapHeaderException Web 服务方法。
Detail不能根据 SOAP 规范设置SoapHeaderException属性。
备注
使用 SOAP 1.1 规范作为服务协议的应用程序可以使用 SoapHeaderException 访问 SOAP 错误。 但是，使用 SOAP 1.2 规范的应用程序必须使用 SoapException 访问 SOAP 错误。
构造函数
属性
| Actor |
获取导致异常的代码段。 (继承自 SoapException) |
| Code |
获取 SOAP 错误代码的类型。 (继承自 SoapException) |
| Data |
获取键/值对的集合，这些键/值对提供有关该异常的其他用户定义信息。 (继承自 Exception) |
| Detail |
获取表示应用程序特定的详细错误信息的 XmlNode。 (继承自 SoapException) |
| HelpLink |
获取或设置指向与此异常关联的帮助文件链接。 (继承自 Exception) |
| HResult |
获取或设置 HRESULT（一个分配给特定异常的编码数字值）。 (继承自 Exception) |
| InnerException |
获取导致当前异常的 Exception 实例。 (继承自 Exception) |
| Lang |
获取与该异常关联的人类语言。 (继承自 SoapException) |
| Message |
获取描述当前异常的消息。 (继承自 Exception) |
| Node |
获取表示导致异常的代码段的 URI。 (继承自 SoapException) |
| Role |
获取一个 URI，它表示用于处理 SOAP 消息的 XML Web services 功能。 (继承自 SoapException) |
| Source |
获取或设置导致错误的应用程序或对象的名称。 (继承自 Exception) |
| StackTrace |
获取调用堆栈上的即时框架字符串表示形式。 (继承自 Exception) |
| SubCode |
获取 SOAP 错误的 |
| TargetSite |
获取引发当前异常的方法。 (继承自 Exception) |
方法
| Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
| GetBaseException() |
当在派生类中重写时，返回 Exception，它是一个或多个并发的异常的根本原因。 (继承自 Exception) |
| GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
使用关于异常的信息设置 SerializationInfo。 (继承自 SoapException) |
| GetType() |
获取当前实例的运行时类型。 (继承自 Exception) |
| MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
| ToString() |
创建并返回当前异常的字符串表示形式。 (继承自 Exception) |
事件
| SerializeObjectState |
已过时。
当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。 (继承自 Exception) |