[C#]DictService
DictService是一個免費的Web Service，可用來做單字與單字的定義查詢，允許非商業與商業使用。
有興趣的可先至Definition Lookup網站上使用看看，輸入關鍵字並選取想要查詢的字典，按下[Search]按鈕搜尋的結果就會顯示在下方。這個Web Service所能提供給我們開發人員的就是這些資訊，像是字典有哪些、搜尋的內容、單字的定義...等。
使用時，我們需先將Web Service加入。可在方案總管上面點選滑鼠右鍵，在滑鼠右鍵選單中選取[Add Service Reference...]。
在[Add Service Reference]對話框中點擊左下方的[Advanced...]按鈕。
在[Service Reference Settings]對話框中點擊左下方的[Add Web Reference...]按鈕。
在[Add Web Reference]對話框中輸入Web Service的網址(http://services.aonaware.com/DictService/DictService.asmx)，再點擊[Add Reference]按鈕將Web Service加入專案參考。
專案參考加入後，在程式中加入DictServceDemo.com.aonaware.services命名空間。
再建立DictService物件就可以使用了。像是DictService.DictionaryList()可以取得字典的列表、DictService.DictionaryInfo()可以取得字典的描述、DictService.Match()與DictService.MatchInDict()可以查詢符合的單字、DictService.Define()與DictService.DefineInDict()可以查詢單字的定義。
這邊示範一個較為完整的使用範例，運行畫面如下：
完整的程式碼如下：
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using DictServceDemo.com.aonaware.services;
namespace DictServceDemo
{
public partial class Form1 : Form
{
#region Var
private DictService _dictService;
#endregion
#region Private Property
public DictService m_DictService
{
get
{
if (_dictService == null)
_dictService = new DictService();
return _dictService;
}
}
#endregion
#region Constructor
public Form1()
{
InitializeComponent();
}
#endregion
#region Event Process
private void Form1_Load(object sender, EventArgs e)
{
cbxDict.DisplayMember = "Name";
cbxDict.DataSource = m_DictService.DictionaryList();
cbxStrategy.DisplayMember = "Id";
cbxStrategy.DataSource = m_DictService.StrategyList();
}
private void lbxResult_SelectedIndexChanged(object sender, EventArgs e)
{
if (cbxDict.SelectedItem == null)
return;
if (lbxResult.SelectedItem == null)
return;
var dict = cbxDict.SelectedItem as Dictionary;
var dictWord = lbxResult.SelectedItem as DictionaryWord;
lbxDefine.DisplayMember = "WordDefinition";
lbxDefine.DataSource = m_DictService.DefineInDict(dict.Id, dictWord.Word).Definitions;
}
private void tbxKeyword_KeyUp(object sender, KeyEventArgs e)
{
if (cbxDict.SelectedItem == null)
return;
if (cbxStrategy.SelectedItem == null)
return;
lbxDefine.DataSource = null;
if (tbxKeyword.Text.Length == 0)
{
lbxResult.DataSource = null;
return;
}
var dict = cbxDict.SelectedItem as Dictionary;
var strategy = cbxStrategy.SelectedItem as Strategy;
lbxResult.DisplayMember = "Word";
lbxResult.DataSource = m_DictService.MatchInDict(dict.Id, tbxKeyword.Text, strategy.Id);
}
#endregion
}
}
看到這邊可能有人會覺得這不會用到，因為字典內的定義資料並不會是我所想要的呈現方式，但是其實他的單字匹配功能倒是滿實用的，像是如果想要檢查單字或是在輸入時給些提示時，這服務就能派上用場，像是下面簡陋的範例一樣。
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using WindowsFormsApplication6.com.aonaware.services;
namespace WindowsFormsApplication6
{
public partial class Form1 : Form
{
#region Var
private AutoCompleteStringCollection _autoCompleteSource;
private DictService _dictService;
#endregion
#region Private Property
private AutoCompleteStringCollection m_AutoCompleteSource
{
get
{
if (_autoCompleteSource == null)
_autoCompleteSource = new AutoCompleteStringCollection();
return _autoCompleteSource;
}
set
{
_autoCompleteSource = value;
}
}
private DictService m_DictService
{
get
{
if (_dictService == null)
{
_dictService = new DictService();
_dictService.MatchInDictCompleted += new MatchInDictCompletedEventHandler(m_DictService_MatchInDictCompleted);
}
return _dictService;
}
}
#endregion
public Form1()
{
InitializeComponent();
textBox1.AutoCompleteMode = AutoCompleteMode.Append;
textBox1.AutoCompleteSource = AutoCompleteSource.CustomSource;
}
#region Event Process
private void textBox1_KeyUp(object sender, KeyEventArgs e)
{
if (textBox1.Text.Length == 0)
return;
textBox1.AutoCompleteCustomSource = m_AutoCompleteSource;
var userState = new object();
m_DictService.CancelAsync(userState);
m_DictService.MatchInDictAsync("wn", textBox1.Text, "prefix", userState);
}
void m_DictService_MatchInDictCompleted(object sender, MatchInDictCompletedEventArgs e)
{
if (e.Cancelled)
return;
m_AutoCompleteSource = new AutoCompleteStringCollection();
m_AutoCompleteSource.AddRange(e.Result.Select((item) => item.Word).ToArray());
}
#endregion
}
}
Download