萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 動態呼叫 WebService (ASMX/WCF) 無需加入 Web 參考完整實作

為什麼需要動態呼叫?

  • 避免「加入 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。
copyright © 萬盛學電腦網 all rights reserved