renjin's blog

為 Windows Form 自動設定等待游標

2011-01-16T16:32:00.034+08:00

在 Windows Form 應用程式中，我們通常會透過變換不同的滑鼠游標形狀（例如沙漏形狀的等待游標），來回應需要使用者等待處理完成的請求，直到處理完成再將游標恢復為預設狀態為止。

為達此目地，一般會在可能需要等待處理的程序中，先將表單的 Cursor 屬性設為 Cursors.WaitCursor，並在作業完成時再將其設為 Cursors.DefaultCursor。同時，為了避免因執行階段的異常情況（Exception）而導致游標狀態異常，會將重設游標的程式碼置於例外處理陳述式的 Finally 區塊中，以確保游標會回復成正常狀態。

雖然，控制游標的作法很簡單，但撰寫仍略嫌瑣碎，如果透過自訂實作 IDisposable 介面的類別，來封裝變更、重設游標的細節，便可讓程式碼更為簡潔，如以下範例：

using(new WaitCursor()) {
   //... some long-running code here
}

採用此實作方式，或許會讓你覺得事情已經簡單到不能再簡單了，但事實上，AutoWaitCursor 類別提供了更佳的實現方法。它會自動偵測表單應用程式是否處於忙碌狀態（停止回應），若忙碌逾指定的 Delay 時間（預設為 25 毫秒），則會自動顯示忙碌游標（預設為等待游標），直到應用程式恢復閒置後重設狀態。你只需在表單建構式中，加入少量的程式碼，便可以為你表單應用程式自動設置等待游標的功能，如以下範例：

AutoWaitCursor.MainWindowHandle = this.Handle;
AutoWaitCursor.Start();

值得注意的是，如果你的表單應用程式使用多執行緒，除非表單的主執行緒被封鎖，否則游標將不會自動改變。

參考資料：
Automatically setting the wait cursor for an application

Printing PDF File from ASP.NET

2010-10-29T20:35:00.027+08:00

使用 PDF（Portable Document Format）文件格式的好處在於，不論使用何種電腦平台或作業系統，都能忠實重現文件的原貌，也不會因為印表機的不同而影響排版。因此，PDF 格式在不同設備上輸出列印的一致性，非常適合用在印表機列印輸出的需求。

在網頁設計實務上，需要動態產生文件及講求排版格式的列印功能亦頗為常見。本文將示範如何使用 iTextShap 建立 PDF 文件，並加入 JavaScript 指令碼透過 Acrobat API 將文件自動輸出至指定的印表機。

下列程式碼範例會假設已經在 ASP.NET Web 網頁建立列印按鈕，並指定如下的 Click 事件處理常式。範例中的 PrintButton_Click 方法，會在指定的目錄下將建立含有列印指令碼的 PDF 文件，並透過泛型處理常式將文件傳送到用戶端，然後輸出至使用者的印表機。

protected void PrintButton_Click(object sender, EventArgs e)
{
    Document document = new Document();                
    MemoryStream ms = new MemoryStream();
    PdfWriter writer = PdfWriter.GetInstance(document, ms);
    document.Open();

    // 加入自動列印指令碼
    writer.AddJavaScript(@"
    var pp = this.getPrintParams();
    pp.interactive = pp.constants.interactionLevel.silent;        
    pp.pageHandling = pp.constants.handling.none;
    var fv = pp.constants.flagValues;
    pp.flags |= fv.setPageSize;
    pp.flags |= (fv.suppressCenter | fv.suppressRotate);
    this.print(pp);
    ");

    document.Add(new Paragraph("Testing Silent Printing with iTextSharp."));
    document.Close();

    Response.ClearContent();
    Response.ClearHeaders();
    Response.ContentType = "application/pdf";
    Response.AddHeader("Content-Disposition", "inline; filename=Report.pdf");
    Response.BinaryWrite(ms.ToArray());
    Response.End();
}

參考資料：
Silent Printing on Web based Java Application

Returning Value from ASPxPopupControl

2010-09-26T12:03:00.017+08:00

ASPxPopupControl 是 Developer Express 在 ASPxperience Suite 裡面所提供的 Web 控制項。你不僅可以利用它填入 HTML 內容外，也可以指定特定的網頁來為你的網頁加入快顯視窗功能。

當你使用 ASPxPopupControl 的 ContentUrl 屬性設定開啟網頁時，它會建立內嵌框架載入網頁內容。為了利於在內嵌網頁中傳遞值給主網頁及隱藏快顯視窗所需的物件參考，需在其 init 事件加入必要的初始化程式碼。

<%@ Page Language="C#" AutoEventWireup="true" %>
<html>
<head runat="server">
    <title>Returning Value from ASPxPopupControl</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>        
        <table border="0">
            <tr>
                <td>
                    <dx:ASPxTextBox ID="supplierTextBox" runat="server" 
                    ClientInstanceName="supplierTextBox" Width="80" />
                </td>
                <td>
                    <dx:ASPxButton ID="popupButton" runat="server" Text="..." />
                </td>
            </tr>
        </table>
        <dx:ASPxPopupControl ID="suppliersPopup" runat="server" 
            ClientInstanceName="suppliersPopup" AllowDragging="True" 
            AllowResize="True" CloseAction="CloseButton" 
            ContentUrl="SlavePage.aspx" Width="400" Height="450" 
            ContentStyle-Paddings-Padding="2" HeaderText="Select Supplier"
            PopupElementID="popupButton">
            <ClientSideEvents Init="function(s, e) {
                    var iframe = s.GetContentIFrame();
                    iframe.contentLoaded = false;
                    var controlCollection = ASPxClientControl.GetControlCollection(); 
                    iframe.popupArguments = {
                        popupContainer: controlCollection.Get('suppliersPopup'),
                        controlToAssign: controlCollection.Get('supplierTextBox')
                    };
            }"></ClientSideEvents>
        </dx:ASPxPopupControl>
    </div>
    </form>
</body>
</html>

以下程式碼示範如何在內嵌框架頁面中傳值給主網頁並隱藏快顯視窗：

<%@ Page Language="C#" AutoEventWireup="true" %>
<html>
<head runat="server">
    <title>Select Supplier</title>
    <script type="text/javascript">
        function getOuterFrame() {
            var iframes = window.parent.document.getElementsByTagName("iframe");
            for (var i = 0, len = iframes.length; i < len; i++) {
                var doc = iframes[i].contentDocument || iframes[i].contentWindow.document;
                if (doc === document) {
                    return iframes[i];
                }
            }
            return null;
        }
        function hidePopupWindow() {
            var outerFrame = getOuterFrame();
            if (outerFrame !== null) {
                outerFrame.popupArguments.popupContainer.Hide();
            }
        }
        function setReturnValue(v) {
            var outerFrame = getOuterFrame();
            if (outerFrame !== null) {
                var controlToAssign = outerFrame.popupArguments.controlToAssign;
                if (controlToAssign) {
                    controlToAssign.SetText(v);
                }
            }
            hidePopupWindow();
        }
    </script>
    <script runat="server">
        void OkButton_Click(object sender, EventArgs e)
        {
            if (grid.FocusedRowIndex > -1)
            {
                object key = grid.GetRowValues(grid.FocusedRowIndex, grid.KeyFieldName);
                Page.ClientScript.RegisterClientScriptBlock(this.GetType(),
                    "SetReturnValue", "setReturnValue('" + key.ToString() + @"');
                ", true);
            }
        }       
    </script>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <dx:ASPxGridView ID="grid" runat="server" 
            ClientInstanceName="grid" DataSourceID="NorthwindDataSource"
            KeyFieldName="SupplierID" AutoGenerateColumns="false" Width="100%">
            <Columns>
                <dx:GridViewDataCheckColumn>
                    <DataItemTemplate>
                        <input type="radio" name="radioButton" />
                    </DataItemTemplate>
                </dx:GridViewDataCheckColumn>
                <dx:GridViewDataColumn FieldName="CompanyName" Caption="Company Name" />
                <dx:GridViewDataColumn FieldName="ContactName" Caption="Contact Name" />
            </Columns>
            <SettingsBehavior AllowFocusedRow="True" />
            <ClientSideEvents FocusedRowChanged="function(s, e) {
               var row = s.GetRow(s.GetFocusedRowIndex());
                if(__aspxIE)
                    row.cells[0].childNodes[0].checked = true;
                else
                    row.cells[0].childNodes[1].checked = true;
            }" />
        </dx:ASPxGridView>
        <br />
        <table border="0" align="center">
            <tr>
                <td>
                    <dx:ASPxButton ID="OkButton" runat="server" Text="OK" 
                           OnClick="OkButton_Click" />
                </td>
                <td>
                    <dx:ASPxButton ID="CancelButton" runat="server" Text="Cancel">
                        <ClientSideEvents Click="function(s, e) {
                        hidePopupWindow();
                        }" />
                    </dx:ASPxButton>
                </td>
            </tr>
        </table>
        <asp:AccessDataSource ID="NorthwindDataSource" runat="server" 
            DataFile="~/App_Data/Northwind.mdb"
            SelectCommand="SELECT * FROM Suppliers"></asp:AccessDataSource>        
    </div>
    </form>
</body>
</html>

Download sample code

SQL Server 連線共用的問題

2010-07-23T15:34:00.014+08:00

在預設的情況下，SQL Server 的 .NET Framework 資料提供者會自動提供連線共用（Connection Pooling），以利提升應用程式的延展性及效能。然而，當 ADO.NET 用戶端嘗試使用共用連線時，有可能會遇到如下的例外狀況：

在傳送要求至伺服器時發生傳輸層級的錯誤。 (provider: TCP 提供者, error: 0 - 遠端主機已強制關閉一個現存的連線。)

A transport-level error has occurred when sending the request to the server. (provider: TCP Provider, error: 0 - An existing connection was forcibly closed by the remote host.)

如果共用連線集區的可用連線與伺服器的連接已嚴重損毀，例如：伺服器重新啟動、容錯移轉、使用者處理序被刪除等，連線共用器並無法立即發現異常，直到將其傳回至 ADO.NET 呼叫端並嘗試與伺服器進行通訊後，才會偵測到連接已損毀。當發生此情況時，連線共用器會從集區中移除該連線，並且擲回如上的例外狀況。

連線共用機制並非能完全保證可用連線的有效性，除非你在連線字串中指定 Pooling=false 明確停用，否則你難以避免此類問題發生。除此之外，建議你在資料存取程式碼中加入例外處理常式因應，或是使用 Retryer Pattern 做最佳的容錯處理。

參考資料：
SQL Server 連接共用 (ADO.NET)

ASP.NET DateDropDown Control

2010-07-03T22:59:00.043+08:00

DateDropDown 是一個使用 UpdatePanel 控制項所建立的連動下拉式日期使用者控制項（User Control）。你可以設定 MinDate 和 MaxDate 屬性，來限制使用者能夠選取的日期範圍，同時也可以搭配驗證控制項檢查使用者輸入的值。

DateDropDown 控制項的完整程式碼如下：
DateDropDown.ascx

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="DateDropDown.ascx.cs" 
Inherits="DateDropDown" %>
<asp:UpdatePanel ID="uxUpdatePanel" runat="server">
    <ContentTemplate>
        <table cellpadding="0" cellspacing="0" border="0">
            <tr>
                <td><asp:DropDownList id="uxYearList" runat="server" AutoPostBack="true" 
                OnSelectedIndexChanged="uxYearList_SelectedIndexChanged">
                </asp:DropDownList></td>
                <td>年</td>
                <td><asp:DropDownList id="uxMonthList" runat="server" AutoPostBack="true" 
                OnSelectedIndexChanged="uxMonthList_SelectedIndexChanged">
                    <asp:ListItem Text="請選擇"></asp:ListItem>
                </asp:DropDownList></td>
                <td>月</td>
                <td><asp:DropDownList id="uxDayList" runat="server">
                    <asp:ListItem Text="請選擇"></asp:ListItem>
                </asp:DropDownList></td>
                <td>日</td>
            </tr>    
        </table>    
    </ContentTemplate>
</asp:UpdatePanel>
<script language="javascript" type="text/javascript">
Sys.WebForms.PageRequestManager.getInstance().add_beginRequest(
function(sender, e) {
    var elem = e.get_postBackElement();
    if (elem.id == '<%= uxYearList.ClientID %>') {
        $get('<%= uxMonthList.ClientID %>').disabled = true;
        $get('<%= uxDayList.ClientID %>').disabled = true;
        $get('<%= this.ClientID %>').value = '';
    }
    else if (elem.id == '<%= uxMonthList.ClientID %>') {
        $get('<%= uxDayList.ClientID %>').disabled = true;
        $get('<%= this.ClientID %>').value = '';
    }     
});
</script>

DateDropDown.ascx.cs

using System;
using System.Reflection;
using System.ComponentModel;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

/// <summary>
/// 連動下拉式日期控制項
/// </summary>
[ValidationProperty("Text")]
public partial class DateDropDown : System.Web.UI.UserControl
{        
    readonly int _maxYear = DateTime.Today.Year + 20;
    readonly int _minYear = DateTime.Today.Year - 20;
    const string _promptText = "請選擇";

    protected void Page_Load(object sender, EventArgs e)
    {
        if (!Page.IsPostBack)
        {
            Initialize();
        }

        ScriptManager.RegisterHiddenField(uxUpdatePanel, this.ClientID, this.Text);
        RegisterScript();        
    }

    private void Initialize()
    {
        if (Initialized)
            return;

        Initialized = true;
        PopulateYearList();
        AssignValidation();
    }

    private void RegisterScript()
    {
        string script = string.Format(
            @"$get('{0}').onchange = function() {{
                $get('{1}').value = 
                    ($get('{2}').selectedIndex > 0 && $get('{3}').selectedIndex > 0 
                    && this.selectedIndex > 0) ?
                    $get('{2}').value + '-' + $get('{3}').value + '-' + this.value : '';
            }};
            ", uxDayList.ClientID, ClientID, uxYearList.ClientID, uxMonthList.ClientID);

        ScriptManager.RegisterStartupScript(Page, Page.GetType(), UniqueID + "_onchange",
            script, true);
    }

    private bool Initialized
    {
        set 
        {
            ViewState["Initialized"] = value;
        }

        get
        {
            if (ViewState["Initialized"] == null)
                ViewState["Initialized"] = false;
            
            return (bool)ViewState["Initialized"];
        }
    }
   
    /// <summary>
    /// 取得選取的日期字串
    /// </summary>
    public string Text
    {
        get
        {
            if (uxYearList.SelectedIndex == 0 || uxMonthList.SelectedIndex == 0 
                || uxDayList.SelectedIndex == 0)
                return string.Empty;

            return new DateTime(int.Parse(uxYearList.SelectedValue), 
                int.Parse(uxMonthList.SelectedValue), 
                int.Parse(uxDayList.SelectedValue)).ToString("yyyy-MM-dd");
        }
    }
    
    /// <summary>
    /// 取得或設定驗證群組名稱
    /// </summary>
    public string ValidationGroup
    {
        get
        {
            return (string)ViewState["ValidationGroup"];
        }
        set
        {
            ViewState["ValidationGroup"] = value;
        }
    }

    /// <summary>
    /// 最小日期值
    /// </summary>
    public DateTime MinDate
    {
        set
        {
            ViewState["MinDate"] = value;
        }

        get
        {
            if (ViewState["MinDate"] == null)            
                ViewState["MinDate"] = new DateTime(_minYear, 1, 1);
            
            return (DateTime)ViewState["MinDate"];
        }
    }

    /// <summary>
    /// 最大日期值
    /// </summary>
    public DateTime MaxDate
    {
        set
        {
            ViewState["MaxDate"] = value;
        }

        get
        {
            if (ViewState["MaxDate"] == null)
                ViewState["MaxDate"] = new DateTime(_maxYear, 12, 31);
            
            return (DateTime)ViewState["MaxDate"];
        }
    }
    
    /// <summary>
    /// 取得或設定選取的日期
    /// </summary>
    public DateTime SelectedDate
    {
        set
        {            
            if (value < MinDate || value > MaxDate)
                throw new ArgumentOutOfRangeException("SelectedDate",
                    "The value should be between 'MinDate' and 'MaxDate'.");

            Initialize();
            uxYearList.SelectedValue = value.Year.ToString();
            (uxYearList as IPostBackDataHandler).RaisePostDataChangedEvent();
            uxMonthList.SelectedValue = value.Month.ToString();
            (uxMonthList as IPostBackDataHandler).RaisePostDataChangedEvent();
            uxDayList.SelectedValue = value.Day.ToString();
            ScriptManager.RegisterExpandoAttribute(uxUpdatePanel,
                ClientID, "value", Text, false);
        }

        get
        {
            Initialize();

            DateTime selectedValue;
            if (DateTime.TryParse(Text, out selectedValue))
                return selectedValue;
                            
            return DateTime.MinValue;
        }
    }

    protected void AssignValidation()
    {
        foreach (Control control in this.Controls)
        {
            PropertyInfo property = control.GetType().GetProperty("ValidationGroup");
            if (property != null)
            {
                property.SetValue(control, ValidationGroup, null);
            }
        }
    }

    private void PopulateYearList()
    {        
        uxYearList.Items.Clear();
        uxYearList.Items.Add(new ListItem(_promptText));

        for (int y = MinDate.Year; y <= MaxDate.Year; y++)
        {
            uxYearList.Items.Add(new ListItem(y.ToString(), y.ToString()));
            if (SelectedDate != DateTime.MinValue && y == SelectedDate.Year)
            {
                uxYearList.Items.FindByValue(y.ToString()).Selected = true;
            }
        }
    }

    private void PopulateMonthList(int year)
    {
        uxMonthList.Items.Clear();
        uxMonthList.Items.Add(new ListItem(_promptText));

        int minMonth = MinDate.Year == year ? MinDate.Month : 1;
        int maxMonth = MaxDate.Year == year ? MaxDate.Month : 12;

        for (int m = minMonth; m <= maxMonth; m++)
        {
            uxMonthList.Items.Add(new ListItem(m.ToString(), m.ToString()));
            if (SelectedDate != DateTime.MinValue && m == SelectedDate.Month)
            {
                uxMonthList.Items.FindByValue(m.ToString()).Selected = true;
            }
        }

        uxMonthList.Enabled = true;
    }

    private void PopulateDayList(int year, int month)
    {        
        uxDayList.Items.Clear();
        uxDayList.Items.Add(new ListItem(_promptText));
        
        int minDay = MinDate.Year == year && MinDate.Month == month ? MinDate.Day : 1;
        int maxDay = MaxDate.Year == year && MaxDate.Month == month ? 
            MaxDate.Day : DateTime.DaysInMonth(year, month);

        for (int d = minDay; d <= maxDay; d++)
        {
            uxDayList.Items.Add(new ListItem(d.ToString(), d.ToString()));
            if (SelectedDate != DateTime.MinValue && d == SelectedDate.Day)
            {
                uxDayList.Items.FindByValue(d.ToString()).Selected = true;
            }
        }

        uxDayList.Enabled = true;
    }

    protected void uxYearList_SelectedIndexChanged(object sender, EventArgs e)
    {
        if (uxYearList.SelectedIndex == 0)
        {
            uxMonthList.SelectedIndex = uxDayList.SelectedIndex = 0;
            uxMonthList.Enabled = uxDayList.Enabled = false;
            return;
        }

        PopulateMonthList(int.Parse(uxYearList.SelectedValue));
    }

    protected void uxMonthList_SelectedIndexChanged(object sender, EventArgs e)
    {
        if (uxMonthList.SelectedIndex == 0)
        {
            uxDayList.SelectedIndex = 0;
            uxDayList.Enabled = false;
            return;
        }

        PopulateDayList(int.Parse(uxYearList.SelectedValue), 
            int.Parse(uxMonthList.SelectedValue));
    }
}

下列程式碼範例要求使用者輸入一個介於 2009-07-01 到 2010-07-01 之間的日期，並使用 RequiredFieldValidator 來確認控制項的輸入。

<uc1:DateDropDown ID="DateDropDown1" runat="server" ValidationGroup="DateDropDown" 
MinDate="2009-07-01" MaxDate="2010-07-01" />
<asp:RequiredFieldValidator ID="RequiredFieldValidator1" runat="server" 
ControlToValidate="DateDropDown1" ValidationGroup="DateDropDown" 
ErrorMessage="Please enter a Date!"></asp:RequiredFieldValidator>

Download DateDropDown.zip

Problem Using INSTEAD OF Triggers with Entity Framework

2009-11-03T15:53:00.006+08:00

若你在使用識別資料行做為主索引鍵的資料表中，定義 INSTEAD OF INSERT 觸發程序，並透過 ObjectContext 的 SaveChanges 方法新增資料時，將會引發 OptimisticConcurrencyException，並導致整個交易復原。以下是發生例外狀況的錯誤訊息：

存放區更新、插入或刪除陳述式影響到非預期數目的資料列 (0)。這些實體載入之後可能被修改或刪除了。請重新整理 ObjectStateManager 實體。

Store update, insert, or delete statement affected an unexpected number of rows (0). Entities may have been modified or deleted since entities were loaded. Refresh ObjectStateManager entries.

如以下範例，會依據 AdventureWorks 實體資料模型的定義，將新的實體物件附加到物件內容：

using (AdventureWorksEntities context = new AdventureWorksEntities()) 
{
    context.AddToSalesReason(new SalesReason() {
        Name = "Recommendation", ReasonType = "Other", ModifiedDate = DateTime.Now
    });
    context.SaveChanges();
}

當呼叫 SaveChanges 方法時，物件服務會產生及執行以下 SQL 命令：

exec sp_executesql N'insert [Sales].[SalesReason]([Name], [ReasonType], [ModifiedDate])
values (@0, @1, @2)
select [SalesReasonID]
from [Sales].[SalesReason]
where @@ROWCOUNT > 0 and [SalesReasonID] = scope_identity()'
,N'@0 nvarchar(14),@1 nvarchar(5),@2 datetime2(7)'
,@0=N'Recommendation',@1=N'Other',@2='2009-11-02 15:14:54.4856524'

因為該實體物件包含識別插入的實體索引鍵，所以會在 INSERT 陳述式後，搭配使用 SCOPE_IDENTITY 函數以取得插入識別欄位中的最後一個識別值。然而，如果此資料表已定義 INSTEAD OF INSERT 觸發程序，則 SCOPE_IDENTITY 函數會因為分屬不同的範圍（Scope）而傳回 NULL 值，於是導致 SaveChanges 失敗，而復原該筆交易並擲回如前述的 OptimisticConcurrencyException 例外狀況。

要解決這個問題，你可以使用預儲程序取代 INSTEAD OF INSERT 觸發程序，然後利用實體資料模型設計工具（Entity Designer），把實體類型的修改函式對應至預存程序。或者，你也可以使用 ExecuteCommand 擴充方法來直接執行新增作業的預儲程序。

How to Fix "Unable to update the EntitySet" Error

2009-10-14T14:42:00.034+08:00

如果你嘗試對資料表實體集進行新增、修改、刪除資料時，有可能會發生無法更新實體集的例外狀況。以下是更新資料時所引發的錯誤訊息：

System.Data.UpdateException: 無法更新 EntitySet '實體集名稱'，因為它有 DefiningQuery，但是在 <ModificationFunctionMapping> 項目中沒有 <UpdateFunction> 項目來支援目前的作業。

Unable to update the EntitySet 'EntitySet Name' because it has a DefiningQuery and no <UpdateFunction> element exists in the <ModificationFunctionMapping> element to support the current operation.

當你將不含主索引鍵的資料表加入實體資料模型（Entity Data Model，EDM）時，Entity Framework 會因為找不到資料表主索引鍵，而將定義建立成唯讀的資料表，也就是在描述儲存結構之 SSDL 區段所定義的 EntitySet 項目中，加入 DefiningQuery 項目以對應到資料存放區的唯讀檢視。所以，當實體集使用定義查詢時，你就無法使用標準更新處理序將保存更新至資料來源。如果嘗試對唯讀的實體集進行更新動作，將會引發如上所述的例外狀況。

要解決這個問題，你可以為來源資料表加入主索引鍵，並透過更新資料庫模型來獲得解決。或者，你也可以利用實體資料模型支援使用預儲程序的功能，定義插入、更新、刪除函式對應來進行資料更新。

在 .NET 應用程式中執行 T-SQL 指令碼檔

2009-09-11T11:35:00.019+08:00

當你在 .NET 應用程式，使用 ADO.NET 提交包含 GO 指令的 T-SQL 批次時，SQL Server 會引發的語法不正確的錯誤。這是因為 GO 指令是 sqlcmd 、osql 等公用程式和 SQL Server 指令碼編輯器所認識的指令，而非有效的 T-SQL 陳述式。

在執行含有一個以上 T-SQL 批次的指令碼時，SQL Server 公用程式會將 GO 視為 T-SQL 陳述式批次結束的信號，並將目前一個或多個 SQL 陳述式的集合傳送至 SQL Server，但並不包含 GO 指令。因此，當你使用 ADO.NET 執行多個 T-SQL 批次的指令碼時，你必須自行過濾 GO 指令，並分批執行 T-SQL 陳述式。

如以下範例使用 EmbeddedResourceTextReader 讀取內嵌資源的 SQL 指令碼檔內容，並透過 Regex 物件以 GO 關鍵字將指令碼分隔成批次陳述式，然後再逐一提交至 SQL Server 執行：

using System;
using System.Data;
using System.Data.SqlClient;
using System.Configuration;
using System.Text.RegularExpressions;

namespace RunSql
{
    class Program
    {
        static void Main(string[] args)
        {            
            string script = new EmbeddedResourceTextReader()
                .GetFromResources("RunSql.Install.sql");
                       
            string[] stmts = Regex.Split(script, "\\sGO\\s", RegexOptions.IgnoreCase);

            using (SqlConnection conn = 
                new SqlConnection(ConfigurationManager
                    .ConnectionStrings["DefaultConnection"]
                    .ConnectionString))
            {
                conn.Open();               
                using (SqlTransaction trans =
                    conn.BeginTransaction(IsolationLevel.ReadUncommitted))
                {
                    using (SqlCommand cmd = conn.CreateCommand())
                    {
                        cmd.Transaction = trans;                        
                        cmd.CommandType = CommandType.Text;
                                                
                        foreach (string stmt in stmts)
                        {
                            cmd.CommandText = stmt.Trim();
                            if (cmd.CommandText.Length > 0)
                            {                                
                                try
                                {
                                    cmd.ExecuteNonQuery();
                                }
                                catch(SqlException) 
                                {
                                    trans.Rollback();
                                    throw;
                                }
                            }                            
                        }
                    }                                        
                    trans.Commit();
                }
            }
        }
    }
}

相較於 ADO.NET，使用 SQL Server Management Objects（SMO）就無須處理 GO 指令的問題，使用起來更為簡便。有關如何使用 SMO 執行 T-SQL 批次的範例程式碼，請參閱這裡。

Using DHTML Tooltips with AJAX

2009-07-22T14:15:00.067+08:00

DHTML Tooltips 是一個跨瀏覽器相容的程式庫，提供豐富的功能讓你可以輕鬆建立、自訂多樣的工具提示（Tooltip）或是彈跳式訊息（Pup-up Box）。

程式庫提供 Tip 函式接受訊息字串參數，而 TagToTip 函式則允許你提供元素的識別名稱以顯示其 HTML 的內容。這兩個函式的用法都相當簡單，在此就不再贅述，本文將會側重在兩者的併用，並透過範例逐步說明告訴你，如何結合 jQuery 的應用來動態載入伺服器所提供的提示訊息。

在以下的範例網頁片段中，你會看到座位平面圖，以及其所組成映射區域，並且繫結要實作動態提示訊息的 onmouseover 事件處理函式。

<img src="Images/seatingplan.png" usemap="#seatingPlan" />
<map name="seatingPlan">
    <area shape="rect" id="Front Stalls" coords="22,100,493,236" 
        onmouseover="showSectionInfo(this, 61);" />
    <area shape="rect" id="Rear Stalls" coords="22,252,492,388" 
        onmouseover="showSectionInfo(this, 62);" />
</map>

在定義 onmouseover 事件處理函式之前，我們先在 jQuery 的 DOM ready 事件中，預先建立一個供資料讀取的過程中顯示處理訊息的隱藏區塊，並將 Tooltips 程式庫中的 UnTip 函式繫結所有映射區域元素的 onmouseout 事件處理常式。

$(document).ready(function() {
    $('<div></div>')
    .attr('id', 'ajaxLoading')
    .html('Loading...')
    .hide()
    .appendTo('body');

    $("map[name='seatingPlan'] *")
    .mouseout(UnTip);
});

當映射區域元素 onmouseover 事件被觸發時，將會執行以下函式並將所接收的傳遞參數做為請求參數，來進行遠端呼叫：

function showSectionInfo(element, sectionId) {
    if (data(element) === undefined) {
        tooltip.call(element, 'ajaxLoading');
        $.ajax({
            url: 'InfoHandler.ashx',
            type: 'GET',
            data: {
                id: sectionId
            },
            dataType: 'html',
            error: function(xhr) {
                UnTip();
                alert('The ajax request failed.');
            },
            success: function(response) {
                data(element, response);
                tooltip.call(element);
            }
        });
    } else {
        tooltip.call(element);
    }
}

在叫用 jQuery 的 ajax 函式處理非同步請求前，會先透過以下所定義的 tooltip 函式叫用 TagToTip 函式將先前所建立的隱藏訊息顯示出來，以回應使用者的請求：

function tooltip(elementId) {
    var options = [ABOVE, true, SHADOW, true];
    if (elementId === undefined) {
        Tip.apply(this, $.merge([data(this)], options));
    } else {
        TagToTip.apply(this, $.merge([elementId], options));
    }
}

當 AJAX 請求成功後，會透過如下的 data 函式將回應結果暫存到元素物件中，提供給後續可能的相同觸發動作讀取之用，以避免冗餘的資料請求。

function data(element, value) {
    return value === undefined ? $.data(element, 'tooltip') :
        $.data(element, 'tooltip', value);
}

最後，再次呼叫 tooltip 函式將回應結果委由 Tip 函式顯示出來。

jQuery Floating Layer Plugin

2009-07-19T14:03:00.059+08:00

在許多網站設計中，浮動圖層（Floating Layer）經常被應用在較長的網頁文件中，以呈現能隨著瀏覽器的捲軸移動的浮動廣告或選單。

Floating Layer Plugin 是以 jQuery 原型物件（Prototype Object）為基礎所擴充的外掛程式庫。相較於先前版本，這次的版本除了將程式碼最佳化外，也增添了若干的新功能。

makeFloating( [options] )
透過元素選取（Selector）將特定的 DOM 元素封裝為具有 jQuery 函式功能的外覆物件後，你可以呼叫此函式來建立自訂的浮動圖層。函式可以接受傳遞物件參數來提供選項設定屬性，如以下所示：

屬性	型別	說明
position	object	指定 x 和 y 屬性來控制浮動區塊的定位方式。除了絕對座標來定位外，你也可以在 x 軸指定 "left"、"right"、"center" 決定水平位置，在 y 軸指定 "top"、"bottom"、"center" 來決定垂直位置。範例： {x:0, y:250} {x:'right', y:'top'}
duration	number	指定動畫的顯示速度，以毫秒為單位。
easing	string	指定變速移動的特效。
fixed	boolean	指定是否要固定圖層位置而不隨捲軸移動。

屬性

型別

說明

position

object

指定 x 和 y 屬性來控制浮動區塊的定位方式。除了絕對座標來定位外，你也可以在 x 軸指定 "left"、"right"、"center" 決定水平位置，在 y 軸指定 "top"、"bottom"、"center" 來決定垂直位置。
範例：

{x:0, y:250}
{x:'right', y:'top'}

duration

number

指定動畫的顯示速度，以毫秒為單位。

easing

string

指定變速移動的特效。

fixed

boolean

指定是否要固定圖層位置而不隨捲軸移動。

應用範例
首先，除了必要的 jQuery 程式庫外，你還需要下載本程式庫並引入到你的網頁中。然後，在網頁的文件的主體中加入區塊圖層，如以下範例：

<div id="floatlayer" style="
    width: 50px;
    height: 50px;
    border: solid 1px #cccccc; 
    background-color: #d0d0ff;
    z-index: 100;
    display: none">
    <!-- Place your content here -->
</div>

接下來，你可以處理 jQuery 的 DOM ready 事件，在網頁載入完成後，選取如上的圖層元素並叫用 makeFloating 函式：

$(document).ready(function() {
    $('#floatlayer').makeFloating();
});

在預設的情況下，浮動圖層會配合網頁的可見區域以水平置左、垂直置中的方式定位，且會隨瀏覽器的捲軸移動產生擺動（Swing）的動畫效果。如果要變更浮動圖層的預設行為，你可以透過物件參數提供自訂的選項設定。如以下範例會建立水平置右、垂直置中，並加入線性（Linear）動畫效果的浮動圖層：

$('#floatlayer').makeFloating({
    position: { x: 'right', y: 'center' },
    easing: 'linear'
});

因為程式所表現的動畫效果是透過 jQuery 的 animate 函式來實現，所以 easing 參數只能支援內建的 linear、swing 兩種特效。如果內建的動畫效果不能符合你的期望，建議你可以搭配 Easing Plugin 來擴增多種慢入（Easing In）和慢出（Easing Out）的動畫效果，如以下範例就使用了更為順暢的慢出特效：

$('#floatlayer').makeFloating({
    position: { x: 'right', y: 'center' },
    easing: 'easeOutBounce'
});

當然，如果你不需要動態移動的效果，你也可以透過物件參數的 fixed 屬性來固定圖層的位置：

$('#floatlayer').makeFloating({
    position: { x: 'right', y: 'center' },
    fixed: true
});

另外，程式庫還提供 floatingPosition 函式，讓你可以在建立浮動圖層物件後，重新定位浮動的目標位置，如以下範例：

$('#floatlayer').floatingPosition({ x: 'center', y: 'center' });

Download jquery.floatinglayer.zip

在 Chrome 2.0 中為 JavaScript 偵錯

2009-06-17T17:20:00.105+08:00

和大多數人一樣，瀏覽器本身對我來說並不重要，它只是瀏覽網頁、使用網路應用的工具而已。相較於瀏覽器的功能性，快速、穩定的基本要素更能貼近我的需求。因此，強調簡潔、快速的 Google Chrome 瀏覽器，很快就在我心中佔據了一個無可取代的地位。

Chrome 不僅滿足使用者對瀏覽器的根本訴求，也從開發人員需求實務上的觀點設計許多的功能，希望能藉以協助開發人員提供更好的使用者經驗。在開發人員的工具中，最令我感興趣的，卻也是對我極度不友善而讓我望之卻步的，莫過於基於命令提示介面的 JavaScript 偵錯工具（JavaScript Debugger）了。當然，這對於既自詡為 Chrome 愛用者，又身兼網頁開發人員的我來說，似乎令人難以悅服。於是，最近我又再度興起要深入研究這個好用的小工具的念頭，如今在此分享自己的學習心得及蒐集的相關資訊，希望能對有興趣的朋友有所幫助。

命令
在 JavaScript 偵錯工具中，可使用的命令會依目前是否處於執行中或是中斷狀態而有所不同。在執行狀態中，也就是網頁尚未執行暫止於中斷點時的狀態下，可以使用的命令如下：

命令	說明
b[reak] <function \| script:function \| script:line \| script:line:pos> [condition]	在來源中的位置或函式設定中斷點。
break_info [breakpoint #] 或 bi [breakpoint #]	顯示目前所有中斷點資訊，或是已指定中斷點的資訊。
clear <breakpoint #>	移除已指定的中斷點。
h[elp] [command]	顯示所有命令的描述，或是已指定命令的詳細描述。
p[rint] <expression>	評估運算式並輸出執行結果。
scripts	顯示所有可偵錯的指令碼資訊。

命令

說明

b[reak] <function | script:function | script:line | script:line:pos> [condition]

在來源中的位置或函式設定中斷點。

break_info [breakpoint #]
或
bi [breakpoint #]

顯示目前所有中斷點資訊，或是已指定中斷點的資訊。

clear <breakpoint #>

移除已指定的中斷點。

h[elp] [command]

顯示所有命令的描述，或是已指定命令的詳細描述。

p[rint] <expression>

評估運算式並輸出執行結果。

scripts

顯示所有可偵錯的指令碼資訊。

註：[] 表示可省略或選擇性項目； <> 表示必須提供的項目。

當網頁暫止於中斷點的狀態時，可以使用的命令如下：

命令	說明
args	顯示目前函數的參數。
b[reak] [<function \| script:function \| script:line \| script:line:pos> [condition]]	在來源中的位置或函式設定中斷點，或是不使用任何參數停止偵錯並終止程式執行。
break_info [breakpoint #] 或 bi [breakpoint #]	顯示目前所有中斷點資訊，或是已指定中斷點的資訊。
backtrace [from frame #] [to frame #] 或 bt [from frame #] [to frame #]	顯示目前函式的呼叫堆疊（Call Stack）。
clear <breakpoint #>	移除已指定的中斷點。
c[ontinue]	繼續執行到下一個中斷點。
dir <expression>	顯示物件的詳細資訊。
f[rame] <frame #>	顯示目前堆疊框架（Stack Frame）的偵錯資訊，或是已指定堆疊框架的偵錯資訊。
h[elp] [command] 或 ? [command]	顯示所有命令的描述，或是已指定命令的詳細描述。
locals	顯示目前堆疊框架中所有變數的值。
n[ext]	逐步執行每行指令碼，如果是執行函式呼叫，則會進入函式內的第一行指令碼。
p[rint] <expression>	評估運算式並輸出執行結果。
scripts	顯示所有可偵錯的指令碼資訊。
source [from line] \| [<from line> <num lines>] 或 ls [from line] \| [<from line> <num lines>]	顯示目前堆疊框架的原始碼，或從指定的行號開始顯示。
s[tep]	逐步執行每行指令碼，如果是執行函式呼叫，則不會進入函式直接執行。
stepout 或 so	在目前的函式中，繼續執行指令碼直到函式返回，然後在呼叫函式的返回點中斷。

命令

說明

args

顯示目前函數的參數。

b[reak] [<function | script:function | script:line | script:line:pos> [condition]]

在來源中的位置或函式設定中斷點，或是不使用任何參數停止偵錯並終止程式執行。

break_info [breakpoint #]
或
bi [breakpoint #]

顯示目前所有中斷點資訊，或是已指定中斷點的資訊。

backtrace [from frame #] [to frame #]
或
bt [from frame #] [to frame #]

顯示目前函式的呼叫堆疊（Call Stack）。

clear <breakpoint #>

移除已指定的中斷點。

c[ontinue]

繼續執行到下一個中斷點。

dir <expression>

顯示物件的詳細資訊。

f[rame] <frame #>

顯示目前堆疊框架（Stack Frame）的偵錯資訊，或是已指定堆疊框架的偵錯資訊。

h[elp] [command]
或
? [command]

顯示所有命令的描述，或是已指定命令的詳細描述。

locals

顯示目前堆疊框架中所有變數的值。

n[ext]

逐步執行每行指令碼，如果是執行函式呼叫，則會進入函式內的第一行指令碼。

p[rint] <expression>

評估運算式並輸出執行結果。

scripts

顯示所有可偵錯的指令碼資訊。

source [from line] | [<from line> <num lines>]
或
ls [from line] | [<from line> <num lines>]

顯示目前堆疊框架的原始碼，或從指定的行號開始顯示。

s[tep]

逐步執行每行指令碼，如果是執行函式呼叫，則不會進入函式直接執行。

stepout
或
so

在目前的函式中，繼續執行指令碼直到函式返回，然後在呼叫函式的返回點中斷。

範例網頁
為了幫助你更快熟悉偵錯命令的應用，將會利用以下範例網頁，用逐步解說的的方式進行偵錯示範。

<html>
<head>
    <title>Sample Page</title>
    <script type="text/javascript" src="shape.js"></script>
    <script type="text/javascript">     
    function Rectangle(x, y, w, h, cnv) {
        Shape.call(this, x, y);
        this.width = w;
        this.height = h;
        this.convas = cnv;
        return true;
    }    
    
    Rectangle.prototype = new Shape();
    Rectangle.prototype.draw = function() {
        if(this.convas) {
            this.convas.innerHTML += "Drawing a Rectangle at:" + this.getCoordinates() +
                    ", width " + this.width + ", height " + this.height + "<br/>";
        }
    };
    
    function drawRectangle() {
        var x = parseInt(document.getElementById("x").value);
        var y = parseInt(document.getElementById("y").value);
        var w = parseInt(document.getElementById("w").value);
        var h = parseInt(document.getElementById("h").value);
        var cnv = document.getElementById("cnv");
        var rect = new Rectangle(x, y, w, h, cnv);
        rect.draw();
    }
    </script>
</head>
<body>
    x:<input id="x" type="text" size="3" /> y:<input id="y" type="text" size="3" />
    width:<input id="w" type="text" size="3" /> height:<input id="h" type="text" size="3" />
    <input type="button" value="Draw Rectangle" onclick="javascript:drawRectangle();" />
    <div id="cnv"></div>
</body>
</html>

在範例網頁中引入一個外部的 js 檔案，其內容如下：

function Shape(x, y) {
    this.x = x;
    this.y = y;
    return true;
}

Shape.prototype = {
    getCoordinates : function() {
        return "(" + this.x + " ," + this.y + ")";
    }
};

當你在 Chrome 中開啟範例網頁後，請按一下 [網頁功能] 功能表，然後在 [開發人員選項] 點選 [為 JavaScript 偵錯] 或是使用鍵盤捷徑 [Ctrl+Shift+L]，這時 JavaScript 偵錯工具便會開啟並附加在作用中的分頁。另外，你還需要 [檢視網頁原始碼]，除了便於在偵錯期間檢視程式碼外，也可以利用原始碼的行號來設定中斷點。

偵錯逐步解說
在進行偵錯前，我們可以在命令列輸入 "scripts" 來檢視附加在範例網頁的指令碼資訊，如以下輸出結果：

$ scripts
file:///C:/shape.js (lines 11)
file:///C:/test.htm (lines 4-30)
[unnamed] (source:"javascript:void(0)")

如果你要將中斷點設在外部檔案中的 Shape 建構函式，你可以執行如下的命令：

$ break Shape
set breakpoint #1

除了指定函式中斷點外，你也可以指定原始碼的位置來設定中斷點。例如，若要將中斷點設在如下的指令碼行：

var rect = new Rectangle(x, y, w, h, cnv);

那麼，你可以先從 [檢視網頁原始碼] 中得知指令碼行所在行號，然後執行如下的命令：

$ break file:///C:/test.htm:28
set breakpoint #2

然而，上述設定中斷點的方式都屬於無條件中斷，事實上，你還可以選擇性地設定需同時符合特定條件的中斷點：

$ break file:///C:/test.htm:24 x<0
set breakpoint #3

這個命令將會在以下的原始碼位置設定中斷點，且變數 x 的值必須滿足特定條件才會暫止程式執行。

var y = parseInt(document.getElementById("y").value);

當你完成如上的中斷點設定後，便可以使用 "break_info" 檢視所有的中斷點資訊：

$ break_info
Num breakpoints: 3
id=1, hit_count=0, type=function, target=Shape
id=2, hit_count=0, type=script, target=file:///C:/test.htm, line=27
id=3, hit_count=0, type=script, target=file:///C:/test.htm, line=23, condition=x<0

現在，你可以回到範例網頁的頁籤，然後填入必要欄位並按下按紐執行指令碼。如果你在 x 欄位輸入的數值小於零的話，那麼程式就會暫止在第三個中斷點：

paused at breakpoint 3: drawRectangle(), file:///C:/test.htm
24:         var y = parseInt(document.getElementById("y").value);

若要繼續執行指令碼，可以視情況選擇使用 "step" 或 "next" 命令來逐行執行指令碼：

$ next
25:         var w = parseInt(document.getElementById("w").value);

或是，使用 "continue" 命令繼續執行到下一個中斷點，也就是之前所設定的第二個中斷點：

$ continue
paused at breakpoint 2: drawRectangle(), file:///C:/test.htm
28:         var rect = new Rectangle(x, y, w, h, cnv);

當程式中斷執行時，可以輸入 "locals" 命令來檢視目前執行函數中的所有變數值：

$ locals
w = 400
cnv = #<an HTMLDivElement>
x = -10
y = 0
h = 600
rect = undefined

若程式繼續執行，將會暫止在第一個中斷點：

$ continue
paused at breakpoint 1: #.Shape(x=-10, y=0), file:///C:/shape.js
2:     this.x = x;

在偵錯過程中，你可以選擇性地切換堆疊框架來進行偵錯。首先，你可以透過 "backtrace" 命令來檢視所有堆疊框架的資訊：

$ backtrace
Frames #0 to #4 of 5:
#00 #<an Object>.Shape(x=-10, y=0) file:///C:/shape.js line 2 column 12 (position 36)
#01 new Rectangle(x=-10, y=0, w=400, h=300, cnv=#<an HTMLDivElement>) file:///C:/test.htm line 7 column 15 (position 58)
#02 drawRectangle() file:///C:/test.htm line 28 column 20 (position 839)
#03 #<an HTMLInputElement>.[anonymous](evt=#<a MouseEvent>) file:///C:/test.htm line 37 column 12 (position 177)
#04 #<an HTMLInputElement>.onclick(evt=#<a MouseEvent>) file:///C:/test.htm line 38 column 4 (position 197)

然後，再使用 "frame" 的命令來切換到指定的堆疊框架，如以下所示：

$ frame 1
#01 Rectangle, undefined
7:         Shape.call(this, x, y);

你可以視需要使用 "source" 命令來檢視目前堆疊框架的原始碼：

$ source
 5: 
 6:     function Rectangle(x, y, w, h, cnv) {
>>>>        Shape.call(this, x, y);
 8:         this.width = w;
 9:         this.height = h;
10:         this.convas = cnv;
11:         return true;
12:     }

如果不打算繼續執行指令碼，請使用 "break" 命令停止偵錯並終止程式執行：

$ break
JavaScript execution already stopped.

參考資料：
Sample debug session with Google Chrome JavaScript debuger
Basic information on Chrome's Debugger
Google Chrome JavaScriptデバッガ完全マニュアル

CKIP Client for .NET

2009-04-16T10:50:00.040+08:00

CKIP 中文斷詞系統是由中文詞知識庫小組（Chinese Knowledge Information Processing Group，CKIP）所發展的線上斷詞服務。此服務採用 XML 資料交換模式，用戶端必須自行撰寫程式經由 TCP Scoket 傳送文本到斷詞系統，並剖析回傳包含斷詞及詞類標記的 XML 處理結果。

目前，CKIP Client 開放原始碼專案已實作 Java、PHP 兩種版本，可以用來簡化 CKIP 斷詞服務用戶端應用程式的開發，而不需自行撰寫 Socket 程式碼及處理 XML 資料。而本文的 CKIP Client for .NET 則是自己重新以 C# 實作 CLR 非同步程式撰寫模型（Asynchronous Programming Model）所設計的斷詞服務用戶端 APIs。

使用範例
下列範例會使用 CkipClient 在同步封鎖模式進行連接、傳送文本，並接收傳回結果，其中 username 及 password 為用戶端所申請之帳號及密碼。

using (CkipClient client = new CkipClient("username", "password"))
{
    client.Send("菩提本無樹，明鏡亦非臺；本來無一物，何處惹塵埃？");
    SegmentationResult result = client.GetResult();

    if (result.StatusCode == StatusCode.Success)
    {
        StringBuilder sb = new StringBuilder();
        foreach (Term term in result.GetTerms())
        {
            sb.Append(term.ToString() + "　");
        }
        Console.WriteLine(sb.ToString());
    }
    else
    {
        Console.WriteLine(string.Format("Error: {0}", result.StatusDescription));
    }
}

輸出結果如下：

菩提(N)　本無樹(N)　，(COMMACATEGORY)　明鏡(N)　亦(ADV)　非(Vt)　臺(N)　；(SEMICOLONCATEGORY)　本來(ADV)　無(Vt)　一(DET)　物(N)　，(COMMACATEGORY)　何處(N)　惹(Vt)　塵埃(N)　？(QUESTIONCATEGORY)

非同步 API 使用範例

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Windows.Forms;
using CKIP;

namespace AsyncCkipClient
{
    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();
        }

        private void uxSend_Click(object sender, EventArgs e)
        {
            CkipClient client = new CkipClient();            
            client.BeginConnect(uxUsername.Text, uxPassword.Text, 
                new AsyncCallback(EndConnectCallback), client);
            DisplayStatus("Connecting to server ...");
        }

        private void EndConnectCallback(IAsyncResult ar)
        {
            CkipClient client = (CkipClient)ar.AsyncState;
            
            try
            {
                client.EndConnect(ar);

                if (client.Connected)
                {
                    client.BeginSend(uxRawText.Text, 
                        new AsyncCallback(EndSendCallback), client);
                    DisplayStatus("Sending data to server ...");             
                }
                else
                {
                    DisplayStatus(string.Format("Ready (last error: {0})", "Connect Failed!"));
                }
            }
            catch (Exception ex)
            {
                client.Close();
                DisplayStatus(string.Format("Ready (last error: {0})", ex.Message));
            }
        }

        private void EndSendCallback(IAsyncResult ar)
        {
            CkipClient client = (CkipClient)ar.AsyncState;

            try
            {
                client.EndSend(ar);                
                client.BeginGetResult(new AsyncCallback(EndGetResultCallback), client);
                DisplayStatus("Reading server response ...");
            }
            catch (Exception ex)
            {
                client.Close();
                DisplayStatus(string.Format("Ready (last error: {0})", ex.Message));
            }
        }

        private void EndGetResultCallback(IAsyncResult ar)
        {
            CkipClient client = (CkipClient)ar.AsyncState;
            try
            {
                SegmentationResult result = client.EndGetResult(ar);

                if (result.StatusCode == StatusCode.Success)
                {
                    StringBuilder sb = new StringBuilder();
                    foreach (Term term in result.GetTerms())
                    {
                        sb.Append(term.ToString() + "　");
                    }
                    DisplayResults(sb.ToString());
                }
                else
                {                    
                    DisplayStatus(string.Format("Ready (last error: {0})", 
                        result.StatusDescription));
                }                
            }
            catch (Exception ex)
            {                
                DisplayStatus(string.Format("Ready (last error: {0})", ex.Message));
            }
            finally
            {
                client.Close();
            }
        }

        public void DisplayResults(string text)
        {
            if (InvokeRequired)
            {
                BeginInvoke(new Action<string>(DisplayResults), text);
                return;
            }
            uxResult.Text = text;
            DisplayStatus("Done");
        }

        public void DisplayStatus(string text)
        {
            if (InvokeRequired)
            {
                BeginInvoke(new Action<string>(DisplayStatus), text);
                return;
            }
            uxStatus.Text = text;
        }        
    }
}

Download source code

參考資料：
實作 CLR 非同步程式撰寫模型 (Programming Model)

如何在資料庫存取組合旗標值

2009-03-16T18:09:00.027+08:00

在程式設計當中，如果要建立可以組合列舉值清單的位元旗標列舉型別時，我們會以 2 的乘冪來定義列舉常數。事實上，在資料庫設計中我們也可以沿用位元旗標列舉的概念，使用單一整數型別的欄位來儲存多個整數常值的組合旗標。

範例資料表
本文將藉以下是範例資料表來示範如何對數值欄位存取組合旗標：

CREATE TABLE [dbo].[User] ( 
 [UserName] [varchar] (20) NOT NULL,
 [Status] [int] NOT NULL DEFAULT 0
)

其中 Status 欄位可以儲存的整數常值以 2 的乘冪定義如下：

狀態	整數	二進位值
APPROVED	1	0001
LOCKED_OUT	2	0010
BANNED	4	0100
DELETED	8	1000

使用 2 的乘冪來定義整數常值，是為了確保在結合的常數中的個別旗標不會重疊。

DELETED	BANNED	LOCKED_OUT	APPROVED	計算	結果
0	0	1	1	1+2	3
0	1	0	1	1+4	5
1	1	0	1	1+4+8	13

加入旗標值
這時我們所定義的常值便可透過位元 OR 運算來組合旗標值。

INSERT INTO [User] VALUES ('Nancy',1|2)
INSERT INTO [User] VALUES ('Robert',1|4)
INSERT INTO [User] VALUES ('Laura',1|2|4|8)
INSERT INTO [User] VALUES ('Andrew',0)
INSERT INTO [User] VALUES ('Janet',1)

當你要測試數值中是否包含特定旗標時，必須先將數值與特定的旗標值進行位元 AND 運算後，再將運算的結果與該旗標值進行相等比較。

SELECT * FROM [User] WHERE Status&2 = 2

UserName	Status
Nancy	3
Laura	15

移除旗標值
若要在數值中移除特定的旗標值，可以將數值與旗標值進行位元互斥 OR 運算。

UPDATE [User]
SET Status = Status^4
WHERE UserName = 'Robert' AND Status&4 = 4

值得注意的是，在對數值與特定的旗標進行位元互斥 OR 運算前，務必先確認該旗標已設定在數值中再執行，否則若貿然對不存在的旗標進行位元互斥 OR 運算將會得到反效果。

參考資料：
Storing Multiple Statuses Using an Integer Column
SQL Server: Updating Integer Status Columns
Integer Based Bit Manipulation - SQL

實作非同步模式的 TCP 用戶端

2009-02-17T09:36:00.022+08:00

TcpClient 類別是以 Socket 類別為基礎所建立的抽象層 TCP 服務，它提供簡單的方法以連接、傳送和接收網路間的資料，用來簡化 TCP 用戶端應用程式的開發。TcpClient 提供同步與非同步兩種通訊模式，本文將會著重探討如何使用非同步程式撰寫模型來處理網路服務要求。

同步模式
在一般的情況下我們都使用同步的封鎖模式來建立 Socket 應用程式，因為這種方式最簡單也最直接。以下範例將會以同步作業的方式發送 HTTP 請求：

using (TcpClient client = new TcpClient("www.msn.com", 80))
{
    using (NetworkStream stream = client.GetStream())
    {
        byte[] send = Encoding.UTF8.GetBytes("GET HTTP/1.0 \r\n\r\n");
        stream.Write(send, 0, send.Length);
        byte[] bytes = new byte[client.ReceiveBufferSize];
        int bytesRead = stream.Read(bytes, 0, (int)client.ReceiveBufferSize);
        String data = Encoding.UTF8.GetString(bytes);
        char[] unused = { (char)data[bytesRead] };
        Console.WriteLine(data.TrimEnd(unused));
    }
}

在上例中，我們使用 TcpClient 的建構式進行同步的連接嘗試，並透過 Stream 通訊端同步收發網路資料。在這段時間內，執行同步要求的執行緒會因為等候網路作業完成而無法再執行其他工作。如果該執行緒是 UI 執行緒，那麼應用程式就被封鎖並停止回應使用者的輸入。雖然使用同步封鎖的 Socket 從觀念上來說比較容易使用，然而如果你的應用程式需要保持快速回應、提升延展性及可靠性，那麼就不應該使用同步封鎖的作業方式。

非同步模式
非同步用戶端通訊端使用標準 .NET Framework 非同步程式撰寫模型，讓你的應用程式不會因為等候同步作業完成的執行緒而被封鎖。因為非同步作業（Asynchronous Operation）會在不同的執行緒上（在背景中）執行，所以應用程式可以在呼叫非同步方法（BeginOperationName）的執行緒上繼續執行指令。例如，在 Windows 應用程式中，非同步執行作業將會委派給背景執行緒，而使用者介面執行緒（在前景中）在作業執行時仍可以保持回應狀態。

接下來，我們將以 Windows Form 應用程式來逐步建構非同步傳輸的 HTTP 用戶端程式。首先，必須先建立用來在非同步呼叫間傳送狀態資訊的狀態物件。然後，呼叫 TcpClient 物件的 BeginConnect 方法開始遠端主機連接的非同步要求。

TcpClient client = new TcpClient();
StateObject state = new StateObject(client);    
state.Data.AppendFormat("GET {0} HTTP/1.0\r\n", url);
state.Data.AppendFormat("Host:{0}\r\n\r\n", hostName);

client.BeginConnect(hostName, 0,
       new AsyncCallback(EndConnectCallback), state);

當完成非同步連線要求時，系統會回呼實作 AsyncCallback 委派的 EndConnectCallback 方法。在這個方法中，我們必須呼叫 EndConnect 方法來結束擱置的非同步連接要求。下列程式碼實作了 EndConnectCallback 方法：

private void EndConnectCallback(IAsyncResult ar)
{
    StateObject state = (StateObject)ar.AsyncState;
    TcpClient client = state.Client;

    try
    {
        client.EndConnect(ar);

        if (client.Connected)
        {
            NetworkStream stream = client.GetStream();
            if (stream.CanWrite)
            {
                byte[] send = Encoding.UTF8.GetBytes(state.Data.ToString());
                stream.BeginWrite(send, 0, send.Length, 
                    new AsyncCallback(EndWriteCallback), state);
            }
        }
        else
        {
            DisplayStatus(string.Format("Ready (last error: {0})", "Connect Failed!"));
        }
    }
    catch (Exception ex)
    {
        client.Close();
        DisplayStatus(string.Format("Ready (last error: {0})", ex.Message));
    }
}

在用戶端通訊端讀寫資料時，我們需要定義一個能儲存非同步作業相關資訊的狀態物件。

internal class StateObject
{
    public readonly TcpClient Client;
    public readonly byte[] Buffer;
    public readonly StringBuilder Data;
    public readonly int BufferSize = 1024;

    public StateObject(TcpClient client)
    {
        this.Client = client;
        this.Data = new StringBuilder();
        this.Buffer = new byte[this.BufferSize];
    }
}

當成功連接到遠端主機後，接著會透過 Stream 通訊端的 BeginWrite 方法以非同步方式將 HTTP 請求字串寫入網路資料流，並於作業完成後回呼實作 AsyncCallback 委派的 EndWriteCallback 方法，這個方法會在網路資料流做好接收準備時接收遠端主機回應的資料。

private void EndWriteCallback(IAsyncResult ar)
{
    StateObject state = (StateObject)ar.AsyncState;
    TcpClient client = state.Client;

    try
    {
        NetworkStream stream = client.GetStream();
        stream.EndWrite(ar);

        state.Data.Length = 0;
        if (stream.CanRead)
        {
            stream.BeginRead(state.Buffer, 0, state.BufferSize, 
                new AsyncCallback(EndReadCallback), state);
        }
    }
    catch (Exception ex)
    {
        client.Close();
        DisplayStatus(string.Format("Ready (last error: {0})", ex.Message));
    }
}

接著會呼叫 Stream 通訊端的 BeginRead 方法，以非同步方式從用戶端通訊端讀取資料，並於作業完成後回呼實作 AsyncCallback 委派的 EndReadCallback 方法，將遠端主機回應的資料讀入資料緩衝區並建立訊息字串。然後再次呼叫 BeginRead 方法，直到用戶端接收資料完畢。

private void EndReadCallback(IAsyncResult ar)
{
    StateObject state = (StateObject)ar.AsyncState;
    TcpClient client = state.Client;
    NetworkStream stream = client.GetStream();

    int bytesRead = stream.EndRead(ar);

    if (bytesRead > 0)
    {
        state.Data.Append(Encoding.UTF8.GetString(state.Buffer, 0, bytesRead));
        stream.BeginRead(state.Buffer, 0, state.BufferSize,
            new AsyncCallback(EndReadCallback), state);
    }
    else
    {
        client.Close();
        DisplayResults(state.Data.ToString());
    }
}

最後，呼叫 DisplayResults 方法將非同步讀取作業所建立訊息字串顯示在 TextBox 控制項。

public void DisplayResults(string text)
{
    if (InvokeRequired)
    {
        BeginInvoke(new Action<string>(DisplayResults), text);
        return;
    }

    int hdrLen = 0;
    if (-1 != (hdrLen = text.IndexOf("\r\n\r\n")))
    {
        uxHeader.Text = text.Substring(0, hdrLen);
        char[] unused = { '\r', '\n', '\r', '\n' };
        uxContent.Text = text.Substring(hdrLen).TrimStart(unused);
    }
    else
    {
        uxHeader.Text = string.Empty;
        uxContent.Text = text;
    }
}

因為 Windows Form 控制項的存取並沒有保證執行緒安全（Thread-safe），也就是說在當一個以上的執行緒同時存取共用資源時，就會發生競爭情形而導致狀態不一致或是死結的情況。所以，在多執行緒的表單中必須以安全執行緒的方式來存取控制項。因此，在 DisplayResults 方法中使用表單的 InvokeRequired 屬性來判斷呼叫端是否來自於建立控制項之執行緒以外的執行緒。如果是跨執行緒呼叫（Cross-Thread），則必須使用 Invoke 或是 BeginInvoke 方法來封送處理（Marshaling）至控制項的執行緒。當你在 Visual Studio 偵錯工具中執行應用程式，若有不安全的執行緒嘗試存取控制項時，偵錯工具會引發 InvalidOperationException 例外狀況：「跨執行緒作業無效: 存取控制項 control name 時所使用的執行緒與建立控制項的執行緒不同」。這也意味只有在偵錯期間才有可能發現這個例外狀況，如果應用程式完成建置與佈署，那麼即使有發生不安全的存取情況也不會引發錯誤，建議你在發現問題時加以修正。

Download sample code

參考資料：
Using an Asynchronous Client Socket
Asynchronous Client Socket Example
Asynchronous operations, pinning
以非同步的方式呼叫同步方法
使用非同步用戶端通訊端

iTextSharp 中文字型解決方案

2009-01-13T18:02:00.022+08:00

iTextSharp 是由 iText（for Java）移植到 .NET 平台的開放原始碼專案。它是一個完全使用 C# 語言所撰寫的 PDF APIs，可以讓你即時建立 PDF 文件。然而，當你要使用 iTextSharp 來建立包含中文字型的文件時，就會面臨無法正常顯示中文的問題。這是因為 iTextSharp 只支援 14 個標準的 Type 1 英文字型，並沒有直接支援中文字型的顯示，取而代之的是你必須自行指定中文字型來源才能獲得解決，所以在此整理顯示中文字的幾種解決方案。

Windows 內建的中文字型
中文版 Windows 內建的中文字型檔可分為 True Type、True Type Collection 及 Open Type 三種字型格式。你可以在 %WINDIR%\Fonts 目錄下找到以 .ttf、.ttc 為延伸檔名的中文字型檔。以下範例將會使用標楷體字型來顯示文字：

Document document = new Document();
PdfWriter.GetInstance(
  document,
  new FileStream(@"cjk.pdf", FileMode.Create)
);
document.Open();

string fontPath = Environment.GetFolderPath(Environment.SpecialFolder.System) +
    @"\..\Fonts\kaiu.ttf";
BaseFont bfChinese = BaseFont.CreateFont(
    fontPath, 
    BaseFont.IDENTITY_H, //橫式中文
    BaseFont.NOT_EMBEDDED
);
Font fontChinese = new Font(bfChinese, 16f, Font.NORMAL);
document.Add(new Paragraph(
    "難得糊塗",
    fontChinese
));
document.Close();

在上例中，你也可以使用 FontFactory 代替 BaseFont 來取得中文字型：

FontFactory.Register(fontPath);
Font fontChinese = FontFactory.GetFont("標楷體", BaseFont.IDENTITY_H, 16f);
document.Add(new Paragraph(
    "吃虧是福",
    fontChinese
));

CID 字型（Character Identity-keyed Fonts）
CID 字型格式通常被應用到中日韓（Chinese Japanese Korean, CJK）字元集。如果要使用 CJK 字型，你就必須搭配額外的亞洲語言包 iTextAsian-1.0.dll。

Document document = new Document();
BaseFont.AddToResourceSearch("iTextAsian.dll");

PdfWriter.GetInstance(
  document,
  new FileStream(@"cjk.pdf", FileMode.Create)
);
document.Open();

BaseFont bfChinese = BaseFont.CreateFont(
  "MHei-Medium",
  "UniCNS-UCS2-H", // 橫式中文
  BaseFont.NOT_EMBEDDED
);
Font fontChinese = new Font(bfChinese, 8);
document.Add(new Paragraph(
    @"聰明難，糊塗難，
由聰明而轉入糊塗更難，
放一著，退一步，當下心安，非圖後來福報也。",
    fontChinese
));
document.Close();

Download sample code

參考資料：
iText Tutorial: Getting fonts

Printing PDF Documents using C#

2009-01-02T16:36:00.025+08:00

在報表應用中，PDF 是常被使用的文件格式，透過 iTextSharp 可以讓你即時（On-The-Fly）建立 PDF 文件。然而，如果你想自動將建立的文件內容輸出至印表機時，可能就會面臨苦無對策的窘境。因為，iTextSharp 並未提供實際的列印文件功能。所幸，這個問題可以藉由動態資料交換（Dynamic Data Exchange, DDE）技術獲得解決，也就是透過 DDE 從 Adobe Reader 來要求列印指定的文件檔案。在 .NET 中，我們可以使用 NDde 這個開放源碼專案，來輕鬆撰寫 DDE 連結的功能。

在接下來的程式碼範例中，除了參考「Printing PDF documents in C#」的做法外，同時亦採用 Clifton Nock 所著「Data Access Patterns」一書中的 Retryer Pattern。以下程式碼是實作 IRetryable 介面的類別，用來執行列印 PDF 文件的工作：

using System;
using System.Diagnostics;
using NDde;
using NDde.Client;

namespace PdfPrintExample
{
    class PdfPrintOperation : IRetryable
    {        
        private DdeClient _client;
        private string _filePath;

        public PdfPrintOperation(string filePath)
        {            
            _filePath = filePath;
            _client = new DdeClient("acroview", "control");
        }
       
        public bool Attemp()
        {
            try
            {
                _client.Connect();
                return true;
            }
            catch (DdeException)
            {        
                // ignore exception        
            }

            return false;
        }

        public void Recover()
        {
            // try running Adobe Reader
            Process p = new Process();
            p.StartInfo.FileName = "AcroRd32.exe";
            p.Start();
            p.WaitForInputIdle();
        }

        public void Print()
        {
            _client.Execute("[DocOpen(\"" + _filePath + "\")]", 60000);
            _client.Execute("[FilePrintSilent(\"" + _filePath + "\")]", 60000);
            _client.Execute("[DocClose(\"" + _filePath + "\")]", 60000);
            _client.Execute("[AppExit]", 60000);
        }
    }
}

以下是簡單的使用範例：

namespace PdfPrintExample
{
    class Program
    {
        static void Main(string[] args)
        {           
            PdfPrintOperation operation = new PdfPrintOperation(@"C:\sample.pdf");
            Retryer retryer = new Retryer(operation);
            retryer.Perform(10, 5000);
            // print the file
            operation.Print();
        }
    }
}

使用 Retryer Pattern 的好處在於連結 DDE Server 發生 DDEException 例外狀況時，可以自動嘗試重新連線，直到連接成功或是達到最大重試次數為止。

Download source code

參考資料：
Printing PDF documents in C#

Useful User-Defined Functions for SQL Server

2008-12-02T11:14:00.017+08:00

在資料庫設計中，我們常會應用預儲程序（Stored Procedure）來對資料進行 CRUD 操作。除此之外，你也可以撰寫自訂函數來應付經常性的資料存取作業或是複雜的計算等等。在這裡，我羅列幾個我在過去開發商務系統中常會應用到的自訂函數。

fn_GetNextBusinessDay
指定起始日期，並傳回最近一個營業日期。

CREATE FUNCTION dbo.fn_GetNextBusinessDay(@StartingDate datetime)
RETURNS datetime
AS  
BEGIN 
    DECLARE @NextBusinessDay datetime

    IF DATEPART(dw, @StartingDate) = (7 - @@DATEFIRST + FLOOR(@@DATEFIRST / 7) * 7) --Saturday
        SET @NextBusinessDay = DATEADD(d, 2, @StartingDate)
    ELSE IF DATEPART(dw, @StartingDate) = (8 - @@DATEFIRST) --Sunday
        SET @NextBusinessDay = DATEADD(d, 1, @StartingDate)
    ELSE
        SET @NextBusinessDay = @StartingDate

    RETURN @NextBusinessDay
END

fn_GetTax
指定銷售額及稅率，並傳回應付的營業稅額。

CREATE FUNCTION dbo.fn_GetTax(@Amount int, @TaxRate real)
RETURNS real
AS  
BEGIN 
    DECLARE @UntaxedPrice int, @Tax int
    SET @UntaxedPrice = ROUND(CAST(@Amount AS real) / (1 + @TaxRate), 0)
    SET @Tax = @Amount - @UntaxedPrice

    RETURN @Tax
END

fn_FormatPercent
指定浮點數資料，並傳回百分比的表示式。

CREATE FUNCTION dbo.fn_FormatPercent(@InputNumber float)
RETURNS varchar(20)
AS
BEGIN
     RETURN CAST(CAST(@InputNumber * 100 AS numeric(10, 0)) AS varchar(20)) + '%'
END

fn_PadLeft
將輸入字串靠右對齊，以特定的字元在左側填補至指定的總長度。

CREATE FUNCTION dbo.fn_PadLeft(@InputString varchar(1024), @PaddingChar char(1), @FieldLength int)
RETURNS varchar(1024)
AS
BEGIN
    DECLARE @PaddingString varchar(1024)
    IF @FieldLength > 0
        SET @PaddingString = RIGHT(REPLICATE(@PaddingChar, @FieldLength) + @InputString, @FieldLength)
    ELSE
        SET @PaddingString = @InputString

   RETURN @PaddingString
END

Read Fixed-Width Text Records using C#

2008-11-15T15:42:00.027+08:00

雖然使用純文字檔格式（Flat File）來交換資料並不是很好的方式，然而在 XML 盛行的今日它仍是普遍存在的資料交換格式。純文字檔格式的資料列通常以特定的符號區隔，或是固定寬度欄位來區隔不同資料欄位。從程式員的觀點來看，處理固定寬度欄位格式的資料並不如使用特定的符號區隔的格式來得輕鬆。如果是使用傳統的方式從「位置」擷取資料，那將會更加麻煩。所以，本文在這裡就要介紹幾種處理固定寬度格式資料的解決方案。

以下範例文字檔內容是以固定寬度格式所描述的銷售訂單內容：

0001S0000120081101       2     5000
0001S0000220081101      10     2500
0001S0000320081101       1    10500

其檔案格式內容定義如下：

欄位名稱	欄位長度
銷售店代號	X(4)
訂單編號	X(6)
訂單日期	X(8)
銷售量	9(8)
銷售金額	9(9)

LINQ to Text Files
首先必須先定義一個延伸方法（Extension Method）來逐行讀取資料流，並建立可以供 LINQ 查詢的可列舉集合。在此我引用了 Eric White 在 LINQ to Text Files 中所提供的 StreamReaderSequence 類別：

public static class StreamReaderSequence
{
    public static IEnumerable<string> Lines(this StreamReader source)
    {
        String line;

        if (source == null)
            throw new ArgumentNullException("source");
        while ((line = source.ReadLine()) != null)
        {
            yield return line;
        }
    }
}

接下來使用規則運算式（Regular expression）依序定義群組編號及資料欄位長度：

Regex re = new Regex("^(?<1>.{4})" +
                    "(?<2>.{6})" +
                    "(?<3>.{8})" +
                    "(?<4>.{8})" +
                    "(?<5>.{9})", 
                    RegexOptions.Compiled);

接著再搭配 LINQ 語法的 let 子句取得規則運算式比對所擷取的群組集合，然後併入查詢結果中：

using (StreamReader sr = new StreamReader(@"d:\orders.txt"))
{                                
    var orders = 
        from line in sr.Lines()
        let fields = re.Match(line).Groups
        select new
        {
            StoreID = fields[1].Value.Trim(),
            OrderNumber = fields[2].Value.Trim(),
            OrderDate = DateTime.ParseExact(fields[3].Value.Trim(), 
                            "yyyyMMdd", CultureInfo.InvariantCulture),
            Quantity = int.Parse(fields[4].Value),
            Amount = int.Parse(fields[5].Value)
        };
  
    foreach (var order in orders)
    {
        Console.WriteLine("{0},{1},{2},{3},{4}",
            order.StoreID,
            order.OrderNumber,
            order.OrderDate,
            order.Quantity,
            order.Amount
        );     
    }
}

LINQ to SQL
Microsoft OLE DB Provider for Jet 可用來存取及查詢文字檔，但必須在文字檔的相同目錄中建立 Schema.ini 檔來描述文字檔的結構：

[orders.txt]
Format=FixedLength
ColNameHeader=False
MaxScanRows=0
Col1=StoreID Text Width 4
Col2=OrderNumber Text Width 6
Col3=OrderDate DateTime Width 8
Col4=Quantity Long Width 8
Col5=Amount Long Width 9
DateTimeFormat=yyyyMMdd

然後，再定義一個資料結構對應的類別：

public class Order
{
    public string StoreID;
    public string OrderNumber;
    public DateTime OrderDate;
    public int Quantity;
    public int Amount;
}

使用 DataContext 物件透過資料庫連接直接執行 SQL 查詢，並傳回資料結構對應的物件集合。

string filePath = @"d:\orders.txt";
string connString = string.Format( @"Provider=Microsoft.Jet.OLEDB.4.0;" +
                    "Data Source={0};" +
                    "Extended Properties='text;HDR=No;Format=FixedLength'",
                    Path.GetDirectoryName(filePath));

OleDbConnection conn = new OleDbConnection(connString);
DataContext db = new DataContext(conn);

string cmdText = string.Format("SELECT * FROM {0}", 
                Path.GetFileName(filePath).Replace(".", "#"));
var orders = db.ExecuteQuery<Order>(cmdText);

foreach (var order in orders)
{                
    Console.WriteLine("{0},{1},{2},{3},{4}",
        order.StoreID,
        order.OrderNumber,
        order.OrderDate,
        order.Quantity,
        order.Amount
    );
}

FileHelpers Library
FileHelpers 是一個用來處理符號區隔或是固定寬度資料的免費類別庫。使用前，你首先必須先定義一個資料結構對應的類別：

[FixedLengthRecord]
public class Order
{
    [FieldFixedLength(4)]        
    public string StoreID;

    [FieldFixedLength(6)]        
    public string OrderNumber;

    [FieldFixedLength(8)]        
    [FieldConverter(ConverterKind.Date, "yyyyMMdd")]
    public DateTime OrderDate;
  
    [FieldFixedLength(8)]
    [FieldTrim(TrimMode.Left)]
    public int Quantity;

    [FieldFixedLength(9)]
    [FieldTrim(TrimMode.Left)]
    public int Amount;
}

然後，透過 FileHelperEngine 讀取資料檔就會自動建立對應的物件陣列。

FileHelperEngine engine = new FileHelperEngine(typeof(Order));          
Order[] orders = engine.ReadFile(@"d:\orders.txt") as Order[];

foreach (var order in orders)
{
    Console.WriteLine("{0},{1},{2},{3},{4}",
        order.StoreID,
        order.OrderNumber,
        order.OrderDate,
        order.Quantity,
        order.Amount
    );
}

參考資料：
LINQ TO Text Files by Eric White

使用 C# 產生網頁縮圖

2008-11-11T11:09:00.028+08:00

在 Web 2.0 網站中，我們常可以看到分享文章或是推薦網站的快照縮圖（Snapshot Thumbnail），來供使用者預覽。如果要在 .NET 中要實做網頁快照，你可以使用 WebBrowser 控制項來達成。在本文中將會示範如何建立 Windows 應用程式來擷取網頁快照並產生縮圖。

範例程式碼

using System;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Windows.Forms;

namespace SnapExample
{
    public partial class MainForm : Form
    {
        private WebPageSnapshot _wps = new WebPageSnapshot(1024, 768);

        public MainForm()
        {
            InitializeComponent();            
            _wps.ImageCompleted += new ImageCompletedEventHandler(RefreshImage);
        }
                               
        private void uxGo_Click(object sender, EventArgs e)
        {
            EnableButtons(false);
            _wps.GenerateAsync(uxUrl.Text);                        
        }

        private void uxSaveAs_Click(object sender, EventArgs e)
        {
            uxSaveFileDialog.DefaultExt = "jpg";
            uxSaveFileDialog.AddExtension = true;
            uxSaveFileDialog.Filter = "JPEG(*.jpg)|*.jpg";
            uxSaveFileDialog.ShowDialog(this);

            string fileName = uxSaveFileDialog.FileName;
            if (fileName != string.Empty)
            {
                uxThumbnail.BackgroundImage.Save(fileName);
            }
        }

        private void RefreshImage(Image image)
        {                        
            decimal sizeRatio = ((decimal)image.Height / image.Width);

            int thumbWidth = 100;
            int thumbHeight = decimal.ToInt32(sizeRatio * thumbWidth);
            
            Image thumb = image.GetThumbnailImage(
                thumbWidth, thumbHeight,
                () => false,
                IntPtr.Zero
            );
                      
            if (WebPageSnapshot.IsBlank((Bitmap)thumb))
            {
                using (Graphics g = Graphics.FromImage(thumb))
                {
                    StringFormat format = new StringFormat();                    
                    format.Alignment = StringAlignment.Center;
                    format.LineAlignment = StringAlignment.Center;
                    g.DrawString(
                        "IMAGE NOT AVAILABLE", 
                        new Font("Tahoma", 65), 
                        Brushes.DarkGray,
                        new RectangleF(0, 0, thumbWidth, thumbHeight), 
                        format
                        );             
                }
            }

            uxThumbnail.BackgroundImage = thumb;           
                                   
            EnableButtons(true);
        }
                
        private void EnableButtons(bool enabled)
        {
            uxSaveAs.Enabled = enabled;
        }

        private void uxCancel_Click(object sender, EventArgs e)
        {
            _wps.CancelAsync();
        }               
    }
}

WebPageSnapshot 是一個以 WebBrowse 類別為對象的自訂外覆類別（Wrapper Class）。透過非同步呼叫 GenerateAsync 方法，會將網頁載入到內部隱含的 WebBrowser 實例中。當 WebBrowser 完整載入網頁後，便會呼叫其 DrawToBitmap 方法建立網頁快照的點陣圖，然後引發 ImageCompleted 事件傳回快照圖。在上例中，將會由 RefreshImage 程序來處理 ImageCompleted 事件，並藉由傳入的 Image 物件的 GetThumbnailImage 方法建立縮圖影像。

不過，在測試過程中發現偶會有擷取到空白影像的情況。為了能處理此例外狀況，我從這裡找來了辨識空白圖片的程式演算法，並引用到 WebPageSnapshot 類別的 IsBlank 靜態方法。在範例中，我就對空白截圖繪製了 "IMAGE NOT AVAILABLE" 的字樣。

Download source code

參考資料：
Algorithm to Detect Blank Images by Chinh Do
Event-based Asynchronous Pattern Overview by Microsoft

ASP.NET Image Uploading with Resizing

2008-11-07T10:38:00.020+08:00

當你使用 ASP.NET 建立上傳圖檔的應用程式時，除了要決定寫入檔案系統或是儲存到資料庫外，你可能還會需要依照原圖的尺寸比例來調整圖片的大小，以符合系統的需求。本文範例程式碼將透過 Image 及 Bitmap 類別，對上傳的原圖進行比例縮放，並以 JPEG 圖檔格式存儲。

<%@ Page Language="C#" %>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="Drawing=System.Drawing" %>
<script runat="server">    
    const string _uploadFolder = "~/images/";
    const int _maxThumbWidth = 100;

    protected void uxUpload_Click(object sender, EventArgs e)
    {
        if (uxImageFile.HasFile)
        {
            if (IsValidImage(uxImageFile.FileName))
            {
                string thumbPath = _uploadFolder + 
                    Path.ChangeExtension(Path.GetRandomFileName(), ".jpg");
                            
                using (Drawing::Image image = 
                    Drawing::Image.FromStream(uxImageFile.PostedFile.InputStream))
                {
                    decimal sizeRatio = ((decimal)image.Height / image.Width);
                    int thumbWidth = _maxThumbWidth;
                    int thumbHeight = decimal.ToInt32(sizeRatio * thumbWidth);

                    using (Drawing::Bitmap bitmap = 
                        new Drawing::Bitmap(image, new Drawing::Size(thumbWidth, thumbHeight)))
                    {
                        bitmap.Save(Server.MapPath(thumbPath), 
                           Drawing::Imaging.ImageFormat.Jpeg);
                    }
                }
                uxThumbImage.ImageUrl = thumbPath;
            }
            else
            {
                // This type of file is not allowed.
                uxThumbImage.ImageUrl = string.Empty;
            }
        }
    }

    public bool IsValidImage(string path)
    {
        return Regex.IsMatch(path, @"(.*?)\.(gif|jpg|jpeg|png)$", RegexOptions.IgnoreCase);
    }
</script>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Image Upload and Resize</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:FileUpload ID="uxImageFile" runat="server" /><br/>
            <asp:Button ID="uxUpload" runat="server"
                Text="Upload" onclick="uxUpload_Click" /><br/>
            <asp:Image ID="uxThumbImage" runat="server" 
                onerror="javascript:this.style.display='none';" />
        </div>
    </form>
</body>
</html>

參考資料：
Create High Quality Thumbnail - Resize Image Dynamically - ASP .Net C# Code

Understanding CSS Positioning

2008-10-27T16:16:00.021+08:00

在網頁中，CSS 將每個元素視為一個矩形區塊（Box）。每個區塊則由內容（Content）、邊距（Padding）、邊框（Border）及邊界（Margin）等區域組合而成，這樣的概念又被稱為區塊模型（Box Model）。

CSS 運用區塊模型的概念，將樣式套用在元素上來決定其外觀及位置。本文接下來將介紹在 CSS 排版中不可或缺的定位（Positioning）觀念。
靜態位置（position:static）
這是所有 HTML 元素預設的 position 屬性值（也就是沒有定位），它會配合版面配置規則（Layout Rule）決定其位置座標。所以，如果在 position:static 的元素設定 top、left、right 或 bottom 等偏移（Offset）屬性將會自動被忽略。

相對位置（position:relative）
相對於原本的位置（靜態位置），也就是將元素從原先的位置，依據元素的偏移屬性，將元素作對應的距離調整，而且其原本位置的區塊空間將會被保留，位移後也可能會覆蓋其它區塊。如果有區塊相互重疊的情況，你可以使用 z-index 屬性來決定重疊的順序。

絕對位置（position:absolute）
以父元素的邊界位置為基點，再依據偏移屬性作對應的距離調整。如果其上層的親代元素都不是以 absolute 或 relative 定位時，那麼就會以 body 元素的邊界為基準。該元素會從 HTML 的正常排版（Normal Flow）中移除，然後再依據容器區塊（Containing Box）的邊界來重新定位該元素，因此也可能會覆蓋其它原塊。而所謂的正常排版是指從上而下、由左至右的編排方式。例如段落區塊（Block Box）會在其容器區塊中從上而下排列；而行內區塊（Inline Box）則是由左至右排列。

固定位置（position:fixed）
基本上與絕對位置的定位方式相同，為一的差別在於其位置固定，且不會隨捲軸的移動而改變，就像浮水印（Watermark）一樣。這個屬性值並不適用 IE 6 或更早期的版本。

參考資料：
CSS basic box model

.NET Naming Conventions

2008-10-14T14:09:00.017+08:00

遵循良好的命名慣例可以讓程式更容易被理解和閱讀。尤其，在團隊工作中採用一致的命名方針將利於程式碼的整合與維護。

匈牙利命名法（Hungarian Notation）是常見的命名方式，如果你在 .NET 程式設計中一眛的沿用匈牙利命名法，不僅無助於提升程式碼的可維護性，甚至會因為命名冗雜造成反效果。果真如此，你就更應該考慮使用更好的命名方式。在這裡推薦由 Pete Brown 依據微軟的開發類別庫的設計方針及業界公認標準（Industry-Accepted Standards）所整理的 .NET 命名準則，非常具有參考價值。

值得一提的是，這份文件還特別針對 Windows 表單和 Web 表單中的 UI 控制項識別名稱，提出獨道的命名原則。雖然作者特別強調不贊成使用匈牙利命名法的原因，然而在不使用匈牙利命名法的原則下，UI 控制項的識別名稱是唯一不在此限的例外。作者建議對所有 UI 控制項的識別名稱，統一採用 "ux"（意即 User eXperience 的縮寫）做為前綴詞（Prefix），其所持的理由如下：

相較於使用型別相依的匈牙利命名法更為簡潔，且不用顧慮變更控制項型別所帶來的名稱衝突問題。
有助於在 Intellisense 中將你的控制項型別變數名稱群組在一起。

如此一來，將可擺脫以往使用繁雜的控制項前綴詞（如 txt、btn 等）的命名方式。如果你也像我一樣常為控制項識別名稱命名感到苦惱，那麼相信採用新命名法將會為你帶來更佳的表單開發經驗。

資料來源：
Common .NET Naming Conventions by Pete Brown

Mooquee - Marquee with Mootools

2008-10-13T15:09:00.022+08:00

Mooquee 是一個以 MooTools 為基礎所設計的跑馬燈的 JavaScript 類別，它提供建構選項可以表現出多種不同於 Marquee 標籤的跑馬燈動畫效果。

實作時，除了要引用 Mooquee 程式庫外，你還需要搭配 MooTools 1.2。在建構 Mooquee 物件時，你可以設定以下建構選項：

element：指定做為跑馬燈區塊的 HTML 元素識別碼。
cssitem：指定播放項目的樣式類別名稱。
firstitem：指定第一個播放項目的索引。
direction：以 up、down、left 或 right 指定跑馬燈移動的方向。
pause：以秒為單位指定每次停止時間，且必須大於或等於 duration 的值，其預設值為 1 秒。
duration：以秒為單位指定每次移動所需時間，其預設值為 1 秒。
overflow：設定當內容超出跑馬燈區塊範圍時的處理方式，預設值為 hidden。
startOnLoad：指定是否自動播放，預設值為 true。

如以下範例會建立向上垂直捲動的跑馬燈：

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Mooquee Example</title>
    <style type="text/css">
        #mooquee_container {
            width: 200px;
            height: 20px;
            border: 1px solid;
        }
        .mooquee_item { 
            background-color: #ffffff; 
        }
    </style>
    <script type="text/javascript" src="mootools-1.2-core.js"></script>
    <script type="text/javascript" src="Mooquee.js"></script>   
    <script type="text/javascript">
        window.addEvent('domready', function() {
            var mooquee = new Mooquee({
                element:'mooquee_container',     
                cssitem:'mooquee_item',
                direction:'up',
                duration:1,
                pause:2,
                firstitem:0
            });
        });
    </script>
</head>
<body>
    <div id="mooquee_container"> 
     <div class="mooquee_item">跑馬燈訊息第 1 則</div> 
     <div class="mooquee_item">跑馬燈訊息第 2 則</div>
     <div class="mooquee_item">跑馬燈訊息第 3 則</div>
    </div>
</body>
</html>

Internet Explorer 8 Web Slices

2008-10-07T10:41:00.017+08:00

Web Slices 是 Internet Explorer 8 的新功能之一，網頁開發者可以在單一網頁中指定多個區塊（Slices）供使用者訂閱到 IE8 新的最愛列（Favorites Bar）。

現在很多網站都會提供 RSS（Really Simple Syndication）的網站內容訂閱服務。使用者只要利用 RSS 閱讀器訂閱內容，就可以方便獲得網站的更新資訊，而不需造訪網站檢閱是否有變更或新資訊。對於提供 RSS 服務的網站來說，它必須提供特定格式的 XML 檔案（亦即 RSS feed）的內容，才能供閱讀器下載及檢查更新。相較之下，Web Slices 並不需要個別的 Feed 檔案，而是直接在網頁中定義 Feed 項目，如以下範例：

<div id="Div1" class="hslice">
    <h4 class="entry-title">Web Slice Title</h4>
    <div class="entry-content">
        This will appear in the preview window.
    </div>
</div>

如你所見，你只要在 HTML 標籤中透過 class 屬性，套用如上例粗體標示的樣式類別名稱，即可在網頁啟用多個 Web Slice。一個最簡單的 Web Slice 至少要具備以下三個要素：

一個套用 hslice 樣式類別的父元素。
父元素的必須具備唯一的 ID 識別名稱。
一個套用 entry-title 樣式類別的子元素。

當 IE 8 偵測到網頁有可用的 Web Slice 時，其工具列上的就會出現綠色的圖示來提示使用者。同時，當使用者的滑鼠游標移至網頁中的 Web Slice 時也會出現相同的圖示。當使用者按下圖示就可訂閱 Web Slices，並將其新增至 [我的最愛] 列。只要使用者訂閱 Web Slices，便可以直接在 [我的最愛] 列開啟快顯視窗預覽到相關資訊。如果有興趣，你可以先體驗 eBay 實作 Web Slices 的專屬網站：htt://ie8.ebay.com/。

相關連結：
New RSS Features for Internet Explorer 8
Internet Explorer 8 Web Slice Style Guide
Internet Explorer 8 Beta 1 Whitepapers - Release WebSlices

AJAX DateTimePicker Extender

2008-10-03T09:37:00.022+08:00

在 Windows Forms 中，有 DateTimePicker 控制項可以用來選擇日期或編輯時間。然而，在 ASP.NET 中只有內建可選取日期的 Calendar Web 伺服器控制項，以及 AJAX Control Toolkit 提供的 Calendar 擴充項外，並沒有兼具選擇日期或編輯時間的 Web 控制項。所幸，jscalendar 正好可以滿足這樣的需求。它是一款功能強大且免費的 DHTML 日期選擇器，不僅內建多種的面板和色彩主題，還支援多國語言顯示介面。

為了能方便引用到 ASP.NET 網頁中，於是自己便著手將 jscalendar 1.0 封裝到自訂的 AJAX DateTimePicker 擴充項控制項。

DateTimePicker 擴充項的屬性

屬性	說明
Align	指定快顯日曆的對齊方式，預設值為 "Br"。詳見對齊方式格式說明。
Format	指示要套用到文字方塊中的日期顯示格式，期預設值為 "%Y-%m-%d"。詳見自訂日期時間格式說明。
FirstDayOfWeek	以 0 到 6 指定每週的起始日，0 表示星期日，1 為星期一，依此類推。預設為星期日。
PopupButtonID	指定用來觸發顯示快顯日曆的控制項識別碼。
TargetControlID	指定顯示選取日期的 TextBox 控制項識別碼。
Theme	預設的日曆面板主題為 Aqua，你可以依照偏好變更為其他的面版樣式：Blue、Blue2、Brown、Green、System、Tas、Win2k1、Win2k2、Win2kCold1、Win2kCold2。
TimeMode	以 12 或 24 定義時間格式，預設為 12 小時制。
SingleClick	指定日期選擇是 Single-Click 或 Double-Click 模式。若指定為 true（預設值）則表示為 Single-Click 模式。
ShowsTime	指定是否顯示時間，若指定為 false（預設值）則表示不顯示。
WeekNumbers	指定是否顯示星期名稱，若指定為 true（預設值）則表示要顯示。

屬性

說明

Align

指定快顯日曆的對齊方式，預設值為 "Br"。詳見對齊方式格式說明。

Format

指示要套用到文字方塊中的日期顯示格式，期預設值為 "%Y-%m-%d"。詳見自訂日期時間格式說明。

FirstDayOfWeek

以 0 到 6 指定每週的起始日，0 表示星期日，1 為星期一，依此類推。預設為星期日。

PopupButtonID

指定用來觸發顯示快顯日曆的控制項識別碼。

TargetControlID

指定顯示選取日期的 TextBox 控制項識別碼。

Theme

預設的日曆面板主題為 Aqua，你可以依照偏好變更為其他的面版樣式：Blue、Blue2、Brown、Green、System、Tas、Win2k1、Win2k2、Win2kCold1、Win2kCold2。

TimeMode

以 12 或 24 定義時間格式，預設為 12 小時制。

SingleClick

指定日期選擇是 Single-Click 或 Double-Click 模式。若指定為 true（預設值）則表示為 Single-Click 模式。

ShowsTime

指定是否顯示時間，若指定為 false（預設值）則表示不顯示。

WeekNumbers

指定是否顯示星期名稱，若指定為 true（預設值）則表示要顯示。

對齊方式格式
使用 Align 屬性可以指定快顯日曆的垂直對齊（Vertical Alignment）及水平對齊（Horizontal Alignment）方式。在 Align 屬性中的第一個字元表示垂直對齊方式，其格式規範如下：

格式	說明
T	下邊緣與目標元素的上邊緣相鄰對齊。
t	下邊緣與目標元素的下邊緣相鄰對齊。
c	垂直置中於目標元素。
b	上邊緣與目標元素的上邊緣相鄰對齊。
B	上邊緣與目標元素的下邊緣相鄰對齊。

格式

說明

下邊緣與目標元素的上邊緣相鄰對齊。

下邊緣與目標元素的下邊緣相鄰對齊。

垂直置中於目標元素。

上邊緣與目標元素的上邊緣相鄰對齊。

上邊緣與目標元素的下邊緣相鄰對齊。

第二個字元表示水平對齊方式，其格式規範如下：

格式	說明
L	右邊緣與目標元素的左邊緣相鄰對齊。
l	左邊緣與目標元素的左邊緣相鄰對齊。
c	水平置中於目標元素。
r	右邊緣與目標元素的右邊緣相鄰對齊。
R	左邊緣與目標元素的右邊緣相鄰對齊。

格式

說明

右邊緣與目標元素的左邊緣相鄰對齊。

左邊緣與目標元素的左邊緣相鄰對齊。

水平置中於目標元素。

右邊緣與目標元素的右邊緣相鄰對齊。

左邊緣與目標元素的右邊緣相鄰對齊。

自訂日期時間格式
以下是使用 Format 屬性指定自訂日期時間格式的規範：

格式	說明
%a	表示星期名稱的縮寫。
%A	表示星期名稱的全名。
%b	表示月份名稱的縮寫
%B	表示月份名稱的全名。
%C	表示世紀的數字。
%d	以 00 到 31 表示月份的日期。
%e	以 0 到 31 表示月份的日期。
%H	以 00 到 23 的數字來表示小時。
%I	以 01 到 12 的數字來表示小時。
%j	本年第幾天。
%k	以 0 到 23 的數字來表示小時。
%l	以 1 到 12 的數字來表示小時。
%m	以 01 到 12 的數字代表月份。
%M	以 00 到 59 的數字來表示分鐘。
%n	表示換行字元。
%p	表示 PM 或 AM。
%P	表示 pm 或 am。
%S	以 00 到 59 的數字來表示秒數。
%s	自 Epoch 系統時間開始所經過的秒數。
%t	表示 Tab 字元。
%U, %W, %V	本年的第幾周。
%u	以星期一為起始序數，從 1 到 7 的數字代表星期的日期。
%w	以星期日為起始序數，從 0 到 6 的數字代表星期的日期。
%y	以兩個位數的數字來表示年份。
%Y	以四個位數的數字來表示年份。
%%	將 % 字元顯示為常值（Literal）。

格式

說明

表示星期名稱的縮寫。

表示星期名稱的全名。

表示月份名稱的縮寫

表示月份名稱的全名。

表示世紀的數字。

以 00 到 31 表示月份的日期。

以 0 到 31 表示月份的日期。

以 00 到 23 的數字來表示小時。

以 01 到 12 的數字來表示小時。

本年第幾天。

以 0 到 23 的數字來表示小時。

以 1 到 12 的數字來表示小時。

以 01 到 12 的數字代表月份。

以 00 到 59 的數字來表示分鐘。

表示換行字元。

表示 PM 或 AM。

表示 pm 或 am。

以 00 到 59 的數字來表示秒數。

自 Epoch 系統時間開始所經過的秒數。

表示 Tab 字元。

%U, %W, %V

本年的第幾周。

以星期一為起始序數，從 1 到 7 的數字代表星期的日期。

以星期日為起始序數，從 0 到 6 的數字代表星期的日期。

以兩個位數的數字來表示年份。

以四個位數的數字來表示年份。

將 % 字元顯示為常值（Literal）。

範例
下列範例會建立能讓使用者選擇日期及時間的日曆：

<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<ace:DateTimePickerExtender ID="DateTimePickerExtender1" runat="server"
TargetControlID="TextBox1"
Format="%Y-%m-%d %H:%M"
ShowsTime="true"
SingleClick="false" />

你也可以加入按鈕來開啟快顯日曆：

<asp:TextBox ID="TextBox2" runat="server"></asp:TextBox>
<asp:Button runat="server" ID="Button2" Text="..." OnClientClick="return false;" />    
<ace:DateTimePickerExtender ID="DateTimePickerExtender2" runat="server"
TargetControlID="TextBox2"
PopupButtonID="Button2"
Format="%Y-%m-%d %H:%M"
ShowsTime="true" />

Download source code - for ASP.NET 3.5

資料來源：
http://sourceforge.net/projects/jscalendar/