SoapException.Code Propriedade

  • Referência

Definição

Namespace:
System.Web.Services.Protocols
Assembly:
System.Web.Services.dll

Obtém o tipo de código de falha de 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

Valor da propriedade

XmlQualifiedName

Um XmlQualifiedName que especifica o código de falha de SOAP ocorrido.

Exemplos

O exemplo de Web Form a seguir chama o Math método de Serviço Web, que gera uma exceção se ocorrer uma divisão por zero. Depois que a exceção é lançada, o Web Form captura a exceção e gera os detalhes da exceção, incluindo as Actor propriedades e Code em um HtmlTable controle .

<%@ 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>

Para que o Web Form anterior use o exemplo de serviço Web XML a seguir Math , um namespace de MyMath foi especificado durante a criação da classe proxy.

<%@ 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

Comentários

A Code propriedade só pode ser definida ao criar uma nova instância da SoapException classe .

A SoapException classe é usada por clientes de serviço Web XML que chamam métodos de serviço Web XML por SOAP. ASP.NET manipula se o cliente que chama usa SOAP. É quando ocorre uma exceção em um serviço Web XML. Se o cliente usar SOAP, ASP.NET encapsulará a exceção específica em um SoapException e definirá as Actor propriedades e Code .

O conjunto de códigos disponíveis, conhecido como Códigos de Falha SOAP para o protocolo SOAP versão 1.1, é o seguinte:

Item Descrição
VersionMismatchFaultCode Um namespace inválido para um envelope SOAP foi encontrado.
MustUnderstandFaultCode Nem todos os elementos SOAP exigem processamento. No entanto, se um elemento SOAP for marcado com o MustUnderstand atributo com um valor de 1, ele será necessário. Falha ao processar o elemento gera essa exceção.
ClientFaultCode Uma chamada de cliente não foi formatada corretamente ou não continha as informações apropriadas. Por exemplo, a chamada do cliente pode não ter as informações de autenticação ou pagamento adequadas. Geralmente, é uma indicação de que a mensagem deve ser alterada antes de ser ressentida.
ServerFaultCode Ocorreu um erro durante o processamento de uma chamada de cliente no servidor, no entanto, o problema não se deve ao conteúdo da mensagem. Por exemplo, um servidor upstream pode não responder a uma solicitação devido a problemas de rede. Normalmente, com esse tipo de exceção, a chamada do cliente pode ter êxito posteriormente. Se um serviço Web XML gerar uma exceção, exceto SoapException e o cliente chamar usando SOAP, ASP.NET converterá a exceção em um SoapException, definindo a Code propriedade como ServerFaultCode e a lançará de volta para o cliente.

Aplica-se a

Confira também