SoapException.Code 属性

  • 参考

定义

命名空间:
System.Web.Services.Protocols
程序集:
System.Web.Services.dll

获取 SOAP 错误代码的类型。

public:
 property System::Xml::XmlQualifiedName ^ Code { System::Xml::XmlQualifiedName ^ get(); };
public System.Xml.XmlQualifiedName Code { get; }
member this.Code : System.Xml.XmlQualifiedName
Public ReadOnly Property Code As XmlQualifiedName

属性值

XmlQualifiedName

一个指定所出现的 SOAP 错误代码的 XmlQualifiedName。

示例

下面的 Web 窗体示例调用 Math Web 服务方法，该方法在发生除以零时引发异常。 引发异常后，Web 窗体将捕获异常并将异常详细信息（包括 Actor 和 Code 属性）输出到 HtmlTable 控件中。

<%@ Page Language="C#" %>
<html>
 <head>
 <script runat=server language="C#">
   void Page_Load(Object o, EventArgs e)
   {
     
   int UsageCount;
   // Create a new instance of the proxy class.
   MyMath.Math math = new MyMath.Math(); 
   // Make a call to the Math XML Web service, which throws an exception.
   try
       {
       math.Divide(3, 0);
       }
   catch (System.Web.Services.Protocols.SoapException error)
       {
       // Populate the table with the exception details.
       ErrorTable.Rows.Add(BuildNewRow("Fault Code Namespace", error.Code.Namespace));
       ErrorTable.Rows.Add(BuildNewRow("Fault Code Name", error.Code.Name));        
       ErrorTable.Rows.Add(BuildNewRow("SOAP Actor that threw Exception", error.Actor));        
       ErrorTable.Rows.Add(BuildNewRow("Error Message", error.Message));        
       return;
       }
   }
 
   HtmlTableRow BuildNewRow(string Cell1Text, string Cell2Text)
   {
       HtmlTableRow row = new HtmlTableRow();
       HtmlTableCell cell1 = new HtmlTableCell();
       HtmlTableCell cell2 = new HtmlTableCell();
         
       // Set the contents of the two cells.
       cell1.Controls.Add(new LiteralControl(Cell1Text));
       // Add the cells to the row.
       row.Cells.Add(cell1);
     
       cell2.Controls.Add(new LiteralControl(Cell2Text));
     
       // Add the cells to the row.
       row.Cells.Add(cell2);
       return row;
     }
 </script>
 </head>
 <body>
     <table id="ErrorTable"
        CellPadding=5 
        CellSpacing=0 
        Border="1" 
        BorderColor="black" 
        runat="server" />
 </body>

<%@ Page Language="VB"%>
<html>
 <head>
 <script runat=server language="VB">
Sub Page_Load(o As Object, e As EventArgs)    
    Dim UsageCount As Integer
    ' Create a new instance of the proxy class.
    Dim math As New MyMath.Math()
    ' Make a call to the Math XML Web service, which throws an exception.
    Try
        math.Divide(3, 0)
    Catch err As System.Web.Services.Protocols.SoapException
        ' Populate our Table with the Exception details
        ErrorTable.Rows.Add(BuildNewRow("Fault Code Namespace", err.Code.Namespace))
        ErrorTable.Rows.Add(BuildNewRow("Fault Code Name", err.Code.Name))
        ErrorTable.Rows.Add(BuildNewRow("SOAP Actor that threw Exception", err.Actor))
        ErrorTable.Rows.Add(BuildNewRow("Error Message", err.Message))
        Return
    End Try
End Sub 'Page_Load


Function BuildNewRow(Cell1Text As String, Cell2Text As String) As HtmlTableRow
    Dim row As New HtmlTableRow()
    Dim cell1 As New HtmlTableCell()
    Dim cell2 As New HtmlTableCell()
    
    ' Set the contents of the two cells.
    cell1.Controls.Add(New LiteralControl(Cell1Text))
    ' Add the cells to the row.
    row.Cells.Add(cell1)
    
    cell2.Controls.Add(New LiteralControl(Cell2Text))
    
    ' Add the cells to the row.
    row.Cells.Add(cell2)
    Return row
End Function 'BuildNewRow
 </script>
 </head>
 <body>
     <table id="ErrorTable"
        CellPadding=5 
        CellSpacing=0 
        Border="1" 
        BorderColor="black" 
        runat="server" />
 </body>

为了使前面的 Web 窗体使用以下 Math XML Web 服务示例，在创建代理类期间指定了 的 MyMath 命名空间。

<%@ WebService Language="C#" Class="Math"%>
 using System.Web.Services;
 using System;
 public class Math : WebService {
     [WebMethod]
     public float Divide(int dividend, int divisor) {
         if (divisor == 0)
             throw new DivideByZeroException();
 
         return dividend/divisor;
     }
  }

<%@ WebService Language="VB" Class="Math"%>
Imports System.Web.Services
Imports System

Public Class Math
    Inherits WebService

    <WebMethod()> _
    Public Function Divide(dividend As Integer, divisor As Integer) As Single
        If divisor = 0 Then
            Throw New DivideByZeroException()
        End If 
        Return Convert.ToSingle(dividend / divisor)
    End Function 'Divide
End Class  'Math

注解

Code只能在创建 类的新实例SoapException时设置 属性。

类 SoapException 供通过 SOAP 调用 XML Web 服务方法的 XML Web 服务客户端使用。 ASP.NET 处理调用的客户端是否使用 SOAP。 这是 XML Web 服务中发生异常的情况。 如果客户端使用 SOAP，ASP.NET 将特定异常包装到 中， SoapException 并设置 Actor 和 Code 属性。

以下为 SOAP 协议版本 1.1 的可用代码集（称为 SOAP 错误代码）：

项 说明
VersionMismatchFaultCode 发现 SOAP 信封的命名空间无效。
MustUnderstandFaultCode 并非所有 SOAP 元素都需要处理。 但是，如果使用值为 1 的属性标记 MustUnderstand SOAP 元素，则需要它。 未能处理 元素将生成此异常。
ClientFaultCode 客户端调用的格式不正确或不包含适当的信息。 例如，客户端调用可能没有正确的身份验证或付款信息。 这通常表明，在重新发送消息之前，必须对其进行更改。
ServerFaultCode 在服务器上处理客户端调用期间发生错误，但问题并非由消息内容导致。 例如，由于网络问题，上游服务器可能无法响应请求。 通常，如果出现此类型的异常，客户端调用可能会在以后成功。 如果 XML Web 服务引发异常，但 SoapException 客户端使用 SOAP 调用，ASP.NET 将异常转换为 ， SoapException将 Code 属性 ServerFaultCode 设置为 ，并将其抛回到客户端。

适用于

另请参阅