SoapException.Detail プロパティ

定義

名前空間:

System.Web.Services.Protocols

アセンブリ:

System.Web.Services.dll

アプリケーション固有のエラー情報を表す XmlNode を取得します。

public:
 property System::Xml::XmlNode ^ Detail { System::Xml::XmlNode ^ get(); };

public System.Xml.XmlNode Detail { get; }

member this.Detail : System.Xml.XmlNode

Public ReadOnly Property Detail As XmlNode

プロパティ値

XmlNode

アプリケーション固有のエラー情報。

例

次の例では、 を SoapExceptionスローします。ここで、XML Web サービス メソッドは プロパティを設定します Detail 。

<%@ WebService Language="C#" class="ThrowSoapException"%>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml.Serialization;
using System.Xml;

public class ThrowSoapException : WebService 
{
    // This XML Web service method generates a SOAP client fault code. 
    [WebMethod]
    public void myThrow(){

        // Build the detail element of the SOAP fault.
        System.Xml.XmlDocument doc = new System.Xml.XmlDocument();
        System.Xml.XmlNode node = doc.CreateNode(XmlNodeType.Element, 
            SoapException.DetailElementName.Name, 
            SoapException.DetailElementName.Namespace);


        // Build specific details for the SoapException.
        // Add first child of detail XML element.
        System.Xml.XmlNode details = doc.CreateNode(XmlNodeType.Element, 
            "mySpecialInfo1", "http://tempuri.org/");
        System.Xml.XmlNode detailsChild = doc.CreateNode(XmlNodeType.Element, 
            "childOfSpecialInfo", "http://tempuri.org/");
        details.AppendChild(detailsChild);

            
        // Add second child of detail XML element with an attribute.
        System.Xml.XmlNode details2 = doc.CreateNode(XmlNodeType.Element, 
            "mySpecialInfo2", "http://tempuri.org/");
        XmlAttribute attr = doc.CreateAttribute("t", "attrName", 
            "http://tempuri.org/");
        attr.Value = "attrValue";
        details2.Attributes.Append(attr);

        // Append the two child elements to the detail node.
        node.AppendChild(details);
        node.AppendChild(details2);

            
        //Throw the exception.    
        SoapException se = new SoapException("Fault occurred", 
            SoapException.ClientFaultCode,Context.Request.Url.AbsoluteUri,node);

        throw se;
        return;    
    }
}

<%@ WebService Language="VB" class="ThrowSoapException"%>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml.Serialization
Imports System.Xml

Public Class ThrowSoapException
    Inherits WebService
    
    ' This XML Web service method generates a SOAP client fault code. 
    <WebMethod()> _
    Public Sub myThrow()
        
        ' Build the detail element of the SOAP fault.
        Dim doc As New System.Xml.XmlDocument()
        Dim node As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            SoapException.DetailElementName.Name, _
            SoapException.DetailElementName.Namespace)
 
        ' Build specific details for the SoapException.
        ' Add first child of detail XML element.
        Dim details As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            "mySpecialInfo1", "http://tempuri.org/")

        ' Add second child of detail XML element with an attribute.
        Dim details2 As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            "mySpecialInfo2", "http://tempuri.org/")
        Dim attr As XmlAttribute = doc.CreateAttribute("t", "attrName", _
            "http://tempuri.org/")
        attr.Value = "attrValue"
        details2.Attributes.Append(attr)

        ' Append the two child elements to the detail node.
        node.AppendChild(details)
        node.AppendChild(details2)
                
        ' Throw the exception.    
        Dim se As New SoapException("Fault occurred", SoapException.ClientFaultCode, _
                                    Context.Request.Url.AbsoluteUri, node)
        Throw se
        Return
    End Sub
End Class

注釈

プロパティは Detail 、値を受け取 Detail るクラス コンストラクターのいずれかを使用して設定できます。

プロパティは Detail 、SOAP 要求の 要素に関連する Body アプリケーション固有のエラーの詳細を提供するために使用されます。 SOAP の仕様に従って、SOAP 要求の 要素が原因でクライアント要求を処理できないために Body エラーが発生した場合は、 プロパティを Detail 設定する必要があります。 SOAP 要求のヘッダー エントリでエラーが発生した場合は、 をスロー SoapHeaderExceptionして、エラーの詳細が SOAP ヘッダーに返されるようにする必要があります。 要素の処理 Body が原因でエラーが発生しない場合は、 プロパティを Detail 設定しないでください。

プロパティの をXmlNodeDetail構築する際には、 Name の プロパティと Namespace プロパティDetailElementNameを使用して、SOAP 仕様との一貫性を確保できます。

detail 要素のすべての直接の子要素は詳細エントリと呼ばれ、各詳細エントリは detail 要素内の独立した要素としてエンコードされます。

こちらもご覧ください

• XmlNode
• SoapHeaderException