為什麼需要動態呼叫?
- 避免「加入 Web 參考」產生大量 Proxy 程式碼,專案更輕量。
- 執行時期決定 WSDL 位址(多環境部署只需改設定檔)。
- 支援不支援靜態 Proxy 的動態場景(如外掛架構)。
核心類別:WebServiceCaller
public static class WebServiceCaller
{
private static readonly Dictionary<string, string> _namespaceCache = new Dictionary<string, string>();
// 1. HTTP POST 呼叫(需 WebService 開啟 HttpPost 協定)
public static XmlDocument QueryPostWebService(string url, string methodName, Hashtable pars) { ... }
// 2. HTTP GET 呼叫(需開啟 HttpGet 協定)
public static XmlDocument QueryGetWebService(string url, string methodName, Hashtable pars) { ... }
// 3. SOAP 1.1/1.2 通用呼叫(最常用)
public static XmlDocument QuerySoapWebService(string url, string methodName, Hashtable pars) {
string ns = _namespaceCache.ContainsKey(url)
? _namespaceCache[url]
: GetNamespace(url); // 首次呼叫解析 WSDL 取得命名空間
return QuerySoapWebService(url, methodName, pars, ns);
}
private static XmlDocument QuerySoapWebService(string url, string methodName, Hashtable pars, string xmlNs) {
var request = (HttpWebRequest)WebRequest.Create(url);
request.Method = "POST";
request.ContentType = "text/xml; charset=utf-8";
request.Headers.Add("SOAPAction", $"\"{xmlNs.TrimEnd('/')}/{methodName}\"");
byte[] soapBody = EncodeParsToSoap(pars, xmlNs, methodName);
using (var stream = request.GetRequestStream()) stream.Write(soapBody, 0, soapBody.Length);
var doc = new XmlDocument();
using (var resp = request.GetResponse())
using (var respStream = resp.GetResponseStream())
doc.Load(respStream);
// 擷取 SOAP Body 內的實際回傳內容
var nsmgr = new XmlNamespaceManager(doc.NameTable);
nsmgr.AddNamespace("soap", "https://schemas.xmlsoap.org/soap/envelope/");
string innerXml = doc.SelectSingleNode("//soap:Body/*/*", nsmgr)?.InnerXml ?? "";
var result = new XmlDocument();
result.LoadXml("<root>" + innerXml + "</root>");
return result;
}
// 解析 WSDL 取得 targetNamespace
private static string GetNamespace(string url) {
using (var client = new WebClient())
using (var stream = client.OpenRead(url + "?wsdl"))
using (var reader = XmlReader.Create(stream)) {
var doc = new XmlDocument();
doc.Load(reader);
return doc.DocumentElement?.GetAttribute("targetNamespace") ?? "";
}
}
// 參數編碼輔助方法略...
}
Web.config 必須啟用的協定(ASMX 專用)
<system.web>
<webServices>
<protocols>
<add name="HttpGet"/>
<add name="HttpPost"/>
</protocols>
</webServices>
</system.web>
呼叫範例
var pars = new Hashtable { {"userId", "123"}, {"action", "query"} };
XmlDocument result = WebServiceCaller.QuerySoapWebService(
"https://localhost:81/Service.asmx", "GetData", pars);
Console.WriteLine(result.OuterXml);
優缺點權衡
| 優點 | 缺點 |
| 零 Proxy 程式碼、部署彈性高 | 失去編譯期型別檢查與 IntelliSense |
| 執行期切換端點極簡單 | 需手工組裝 SOAP 標頭,易拼錯 |
| 適合外掛/動態載入架構 | 複雜型別(陣列、巢狀物件)序列化需自行處理 |
現代替代方案
- WCF ChannelFactory<T>:共用合約介面組件,動態建立通道,保留強型別。
- HttpClient + JSON:新專案優先考慮 RESTful API,避免 SOAP 複雜度。
- Refit / RestEase:聲明式 HTTP 客戶端,介面即 Proxy。