ASP.NET Web Service (.asmx) 雖屬舊技術 (現推薦 WCF/Web API),但維護舊系統仍需了解。本文詳述建立流程、指令屬性、屬性標記與實戰範例。
<%@ WebService Language="C#" CodeBehind="~/App_Code/Service.cs" Class="Service" %>
| 屬性 | 說明 |
|---|---|
| Language | 程式語言 (C#/VB/JScript),可選,預設依副檔名推斷 |
| Class | 實作 Web Service 的類別名稱 (必要) |
| CodeBehind | 原始碼檔案路徑 (VS2008 放在 App_Code) |
| Debug | 是否啟用偵錯編譯,預設 false (受 web.config 控制) |
using System;
using System.Web.Services;
using System.Web.Services.Protocols;
[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
// [System.Web.Script.Services.ScriptService] // 啟用 AJAX 呼叫時取消註解
public class Service : System.Web.Services.WebService {
public Service() {
// InitializeComponent();
}
[WebMethod]
public string HelloWorld() {
return "Hello World";
}
}
https://www.mycompany.com/),開發階段可用 https://tempuri.org/Name、DescriptionConformsTo = WsiProfiles.BasicProfile1_1 宣告符合 WS-I Basic Profile 1.1 互通性標準WebServiceBinding 實作多重繫結公開方法必須標記此屬性才能被遠端呼叫。支援屬性:
| 屬性 | 功能 | 預設值 |
|---|---|---|
| BufferResponse | 啟用回應緩衝 (true=完整緩衝後送出) | true |
| CacheDuration | 快取秒數 (0=停用),依參數組合快取 | 0 |
| Description | 說明文字,顯示於測試頁 | "" |
| EnableSession | 啟用 Session 狀態 | false |
| MessageName | 方法別名,解決多載衝突 (Web Service 不支援多載) | 方法名 |
[WebMethod(Description = "輸入聯絡人姓名,回傳詳細資訊")]
public string Select(string stuName) {
// 1. 連線 Access 資料庫
string connStr = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" +
Server.MapPath("~/App_Data/db18.mdb");
using (OleDbConnection conn = new OleDbConnection(connStr)) {
conn.Open();
// 2. 參數化查詢 (防 SQL Injection)
using (OleDbCommand cmd = new OleDbCommand(
"SELECT * FROM 聯絡人 WHERE 姓名 = @Name", conn)) {
cmd.Parameters.AddWithValue("@Name", stuName);
using (OleDbDataReader dr = cmd.ExecuteReader()) {
if (dr.Read()) {
return string.Format("姓名:{0},地址:{1},公司:{2},頭銜:{3}",
dr["姓名"], dr["地址"], dr["公司名稱"], dr["頭銜"]);
}
return string.IsNullOrEmpty(stuName)
? "<font color='blue'>請輸入姓名</font>"
: "<font color='red'>查無此人!</font>";
}
}
}
}
App_Codehttps://localhost/YourService.asmx → 出現測試頁XmlSerializer)、無 REST 支援