SoapException.Code Свойство

Определение

Получает тип кода ошибки SOAP.

public System.Xml.XmlQualifiedName Code { get; }

Значение свойства

Объект XmlQualifiedName, указывающий код происшедшей ошибки SOAP.

Примеры

В следующем примере веб-формы вызывается Math метод веб-службы, который создает исключение, если происходит деление на ноль. После создания исключения веб-форма перехватывает исключение и выводит сведения об исключении, включая 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>

Чтобы предыдущая веб-форма использовала следующий Math пример веб-службы XML, при создании прокси-класса было указано пространство имен 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;
     }
  }

Комментарии

Свойство Code можно задать только при создании нового экземпляра SoapException класса .

Класс SoapException предназначен для использования клиентами веб-службы XML, которые вызывают методы веб-службы XML по протоколу SOAP. ASP.NET определяет, использует ли клиент, вызывающий протокол SOAP. Это происходит при возникновении исключения в веб-службе XML. Если клиент использует ПРОТОКОЛ SOAP, ASP.NET заключает конкретное исключение в SoapException и задает Actor свойства и Code .

Ниже приведен набор доступных кодов, известных как коды ошибок SOAP для протокола SOAP версии 1.1.

Элемент Описание
VersionMismatchFaultCode Обнаружено недопустимое пространство имен для конверта SOAP.
MustUnderstandFaultCode Не все элементы SOAP требуют обработки. Однако если элемент SOAP помечен MustUnderstand атрибутом со значением 1, он является обязательным. Если не обработать элемент, это исключение возникает.
ClientFaultCode Вызов клиента был отформатирован неправильно или не содержал соответствующих сведений. Например, вызов клиента может не иметь надлежащей информации для проверки подлинности или оплаты. Как правило, это указывает на то, что сообщение должно быть изменено, прежде чем оно будет повторно отправлено.
ServerFaultCode Во время обработки вызова клиента на сервере произошла ошибка, однако проблема не связана с содержимым сообщения. Например, сервер вышестоящий может не отвечать на запрос из-за проблем с сетью. Как правило, при таком типе исключения вызов клиента может завершиться успешно позже. Если веб-служба XML создает исключение, отличное SoapException от и клиент вызывает с помощью ПРОТОКОЛА SOAP, ASP.NET преобразует исключение SoapExceptionв , присвоив свойству Code значение ServerFaultCode и возвращает его клиенту.

Применяется к

Өнім Нұсқалар
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

См. также раздел