SoapException.Detail プロパティ

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

プロパティ値

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

例

次の例では、 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 要求のヘッダー エントリでエラーが発生した場合は、エラーの詳細が SOAP ヘッダーに返されるように、 SoapHeaderExceptionをスローする必要があります。 Body要素の処理のためにエラーが発生しない場合は、Detail プロパティを設定しないでください。

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

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

こちらもご覧ください

• XmlNode
• SoapHeaderException