Web Service入門 #9，SoapException例外狀況

2009-09-23

11341
0
Web Service與 WCF
2011-11-24

我們用兩個範例，來瞭解 Web Service的例外狀況（Exception），也就是 SoapException。

這個範例的原始出處，是MSDN的

http://msdn.microsoft.com/zh-tw/library/system.web.services.protocols.soapexception.aspx

我們用兩個範例，來瞭解 Web Service的例外狀況（Exception），也就是 SoapException。

對於 Web Service不熟悉的初學者，可以從這篇文章入門 -- Web Service入門#8，完整章節，搶先觀看

目前本網站已經完成的 Web Service文章已經有很多篇，請參考以下的文章

由淺入深，慢慢來：

http://www.dotblogs.com.tw/mis2000lab/Tags/Web%20Service/default.aspx

....................................................................................................................................................................

首先，我們的 Web Service程式（.asmx的後置程式碼）如下

Imports System.Web Imports System.Web.Services Imports System.Web.Services.Protocols '----自己寫的 for Exception---- Imports System.Xml.Serialization Imports System.Xml ' 若要允許使用 ASP.NET AJAX 從指令碼呼叫此 Web 服務，請取消註解下一行。 ' <System.Web.Script.Services.ScriptService()> _ <WebService(Namespace:="http://tempuri.org/")> _ <WebServiceBinding(ConformsTo:=WsiProfiles.BasicProfile1_1)> _ <Global.Microsoft.VisualBasic.CompilerServices.DesignerGenerated()> _ Public Class Service_9_Exception Inherits System.Web.Services.WebService '<WebMethod()> _ 'Public Function HelloWorld() As String ' Return "Hello World" 'End Function ' This XML Web service method throws a SOAP client fault code. '--參考資料：http://msdn.microsoft.com/zh-tw/library/aa720122(VS.71).aspx <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 (SoapException). Dim se As New SoapException("Fault occurred", _ SoapException.ClientFaultCode, _ Context.Request.Url.AbsoluteUri, _ node) '--註：node就是一份XML文件（上面寫好的 doc與 node變數） Throw se Return End Sub End Class

然後，我們寫一個 ASP.NET網頁程式（.aspx）來承接這個 SoapException例外狀況

後置程式碼如下：

'----自己寫的 for Exception---- Imports System.Web.Services.Protocols Imports System.Xml Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load Dim ThrowsSoapException As New localhost.Service_9_Exception Try ThrowsSoapException.myThrow() Catch ex As SoapException ' 例外狀況可以分成這麼多不同的 SoapException屬性： Response.Write("<hr> Fault Code Namespace--- " & ex.Code.Namespace) Response.Write("<hr> Fault Code Name--- " & ex.Code.Name) Response.Write("<hr> SOAP Actor that threw Exception（Web Service程式名稱）--- " & ex.Actor) Response.Write("<hr> Error Message（例外訊息、程式、Method）--- " & ex.Message) Response.Write("<hr> Detail（XML內容）--- " & HttpUtility.HtmlEncode(ex.Detail.OuterXml)) End Try End Sub

程式執行結果：

從程式的執行結果裡面，

1. 我們可以抓取到 Web Service程式傳來的例外狀況。

SoapException的第一個參數字串（如上圖）

         Dim se As New SoapException("Fault occurred", _
            SoapException.ClientFaultCode, _
            Context.Request.Url.AbsoluteUri, _
            node)    '--註：node就是一份XML文件（Web Service程式裡面，寫好的 doc與 node變數）

Throw se

2. 也可以抓到 Web Service程式裡面，拋出例外狀況的 Method....

---------------------------------------------------------------------------------------------------------------------------------------------------

關於本網站的 Web Service，已經發表一系列文章，

請看：http://www.dotblogs.com.tw/mis2000lab/Tags/Web%20Service/default.aspx

2009/11/10補充： 本系列 Web Service文章已經延伸許多範例與程式，並撰寫成書本裡面的一章，

將會發表在這一本書裡面，請看：[預告]ASP.NET專題實務（下集）-- 範例集與.NET 4.0新功能

我將思想傳授他人，他人之所得，亦無損於我之所有；

猶如一人以我的燭火點燭，光亮與他同在，我卻不因此身處黑暗。----Thomas Jefferson

線上課程，遠距教學 (Web Form 49hr) https://dotblogs.com.tw/mis2000lab/2016/02/01/aspnet_online_learning_distance_education_VS2015

線上課程，遠距教學 (ASP.NET MVC 75~80hr) https://dotblogs.com.tw/mis2000lab/2018/08/14/ASPnet_MVC_Online_Learning_MIS2000Lab

ASP.NET MVC線上課程第一天免費看 (5.5小時)

寫信給我，不要私訊 -- mis2000lab (at) yahoo.com.台灣 或 school (at) mis2000lab.net

ASP.NET遠距教學、線上課程（Web Form + MVC）。 第一天課程， "完整" 試聽。

................ facebook社團 https://www.facebook.com/mis2000lab ......................

................ YouTube (ASP.NET) 線上教學影片 https://www.youtube.com/channel/UC6IPPf6tvsNG8zX3u1LddvA/

Blog文章 "附的範例" 無法下載，請看 這裡 ...... https://dotblogs.com.tw/mis2000lab/2016/03/14/2008_2015_mis2000lab_sample_download

請看我們的「售後服務」範圍（嚴格認定）。

......................................................................................................................................................