SoapException.Code Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.XmlQualifiedNamePublic ReadOnly Property Code As XmlQualifiedNameValor da propriedade
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. |
