C# 封裝控件學習（3）

前兩篇介紹了服務器控件的基本顯示，屬性的設定，繼承Webcontrol開發控件等內容，這篇介紹下定製服務器控件的事件的處理和回傳數據的處理。

當ASP.NET頁面處理回傳到服務器端的表單時，兩種信息會傳遞給頁面中的控件：

回傳事件，如Button一類控件觸發的回傳，會引發服務器端事件；

回傳數據：是Web表單中包含的數據，該數據是在Web表單提交到服務器端時傳遞給如TextBox一類的控件。

處理回傳數據

PostBack（回傳）：ASP.NET控件提交表單到服務器端，將信息從瀏覽器傳遞到服務器端的過程。

我們可能經常會在Page_Load事件中寫這樣的代碼：

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

但是初學的時候我們很少回去問，爲什麼要寫這段代碼，只知道這麼寫就是對的。其實這就是數據回傳的一個表現，通過該值指示該頁是否正爲響應客戶端回發而加載。

ASP.ENT服務器控件處理回傳數據，基本上完成以下兩個工作：

-->繼承並實現IPostBackDataHandler接口的

-->實現RaisePostDataChangedEvent方法,處理回發數據

通過例子說明一下，這裏創建一個自己的文本框：創建一個ASP.NET服務器控件項目(MyTextBox)

namespace NewTextBox
{
    [DefaultProperty("Text")]
    [ToolboxData("<{0}:NewTextBox runat=server></{0}:NewTextBox>")]
    public class NewTextBox : WebControl, IPostBackDataHandler
    {
        public event EventHandler TextChanged;

        public string ViewText//定義顯示文字屬性
        {
            get
            {
                if (ViewState["Text"].Equals(null))
                {
                    return String.Empty;
                }
                else
                {
                    return ViewState["Text"].ToString();
                }
            }
            set
            {
                ViewState["Text"] = value;
            }
        }

        protected override HtmlTextWriterTag TagKey//向頁面中添加文本框
        {
            get
            {
                return HtmlTextWriterTag.Input;
            }
        }

        protected override void AddAttributesToRender(HtmlTextWriter writer)
        {
            writer.AddAttribute(HtmlTextWriterAttribute.Type, "text");
            writer.AddAttribute(HtmlTextWriterAttribute.Value, ViewText);
            writer.AddAttribute(HtmlTextWriterAttribute.Name, this.UniqueID);

            base.AddAttributesToRender(writer);
        }

        public bool LoadPostData(string postDataKey, System.Collections.Specialized.NameValueCollection postCollection)//表單域的值和控件的ViewText(此示例中)屬性的當前值不匹配，那麼將新的值賦給ViewText屬性，並且返回True。只有當LoadPostData返回True的時候，纔會調用RaisePostDataChangedEvent方法。

        {
            if (postCollection[postDataKey] != ViewText)
            {
                ViewText = postCollection[postDataKey];
                return true;
            }
            return false;
        }

        public void RaisePostDataChangedEvent()
        {
            if (TextChanged != null)
                TextChanged(this, EventArgs.Empty);
        }

    }
}

測試一下：

protected void Button1_Click(object sender, EventArgs e)
        {
            Label1.Text = NewTextBox1.ViewText;
        }

只有當文本框中是文字發生變化是，纔會引起數據的回發並從新獲得數據。（控件拖到頁面時，要給viewText賦值）

處理回發事件

ASP.NET服務器控件處理回發事件，基本上需要完成以下兩個工作：

-->繼承並實現IPostBackEventHandler接口的

-->實現RaisePostBackEvent方法,處理回發事件

Button控件繼承IPostBackEventHandler接口(所有的按鈕控件，ImageButton，LinkButtton都繼承了這個接口)。IPostBackEventHandler接口專門定義了處理回發事件的方法，如果自定義控件需要處理回發事件，你就需要繼承IPostBackEventHandler接口。

通過例子說明一下，這裏我們定製一個自己的按鈕：創建一個ASP.NET服務器控件項目(MyButton)

namespace MyButton
{
    [DefaultProperty("Text")]
    [ToolboxData("<{0}:MyButton runat=server></{0}:MyButton>")]
    public class MyButton : WebControl, IPostBackEventHandler
    {
        private static readonly object ClickKey = new object();

        public event EventHandler Click //定義事件的委託
        {
            add
            {
                Events.AddHandler(ClickKey, value);
            }
            remove
            {
                Events.RemoveHandler(ClickKey, value);
            }
        }

        protected virtual void OnClick(EventArgs e)//定義單擊事件的處理程序
        {
            EventHandler clickEventDelegate = (EventHandler)Events[ClickKey];

            if (clickEventDelegate != null)
            {
                clickEventDelegate(this, e);
            }
        }

        public void RaisePostBackEvent(string eventArgument)//處理回發事件
        {
            OnClick(new EventArgs());
        }

        protected override void RenderContents(HtmlTextWriter output)
        {
            output.Write("<INPUT TYPE=submit name=" + this.UniqueID +
                " Value='這是自己定製的按鈕！' />");
        }
    }
}

測試一下：

protected void MyButton1_Click(object sender, EventArgs e)
        {
            Label1.Text = "Hello World!!!!!!!!!";
        }

按鈕的事件回發處理成功。

客戶端回發事件

在asp.net2.0中,Button 控件多了一個UseSubmitBehavior 屬性,指示 Button 控件使用客戶端瀏覽器的提交機制(客戶端回發)還是 ASP.NET 回發機制,默認採用ASP.NET回發機制,如果設置爲false的話,則需要調用GetPostBackEventReference 方法來返回 Button 的客戶端回發事件。

當設置UseSubmitBehavior 屬性爲flase時,運行頁面時,則會發現一段自動生成的javascript代碼（查看源文件）

<script type="text/javascript">
//<![CDATA[
var theForm = document.forms['form1'];
if (!theForm) {
    theForm = document.form1;
}
function __doPostBack(eventTarget, eventArgument) {
    if (!theForm.onsubmit || (theForm.onsubmit() != false)) {
        theForm.__EVENTTARGET.value = eventTarget;
        theForm.__EVENTARGUMENT.value = eventArgument;
        theForm.submit();
    }
}
//]]>
</script>

這裏我們創建一個按鈕，根據屬性的設定，更改其事件回發的方式：

namespace MyLinkButton
{
    [DefaultProperty("Text")]
    [ToolboxData("<{0}:MyLinkButton runat=server></{0}:MyLinkButton>")]
    public class MyLinkButton : WebControl, IPostBackEventHandler
    {
        public virtual ButtonDisplay Display
        {
            get
            {
                object display = ViewState["Display"];
                if (display == null)
                    return ButtonDisplay.Button;
                else
                    return (ButtonDisplay)display;
            }
            set
            {
                ViewState["Display"] = value;
            }
        }

        public virtual string Text
        {
            get
            {
                object text = ViewState["Text"];
                if (text == null)
                    return string.Empty;
                else
                    return (string)text;
            }
            set
            {
                ViewState["Text"] = value;
            }
        }

        private static readonly object ClickKey = new object();

        public event EventHandler Click//定義委託
        {
            add
            {
                Events.AddHandler(ClickKey, value);
            }
            remove
            {
                Events.RemoveHandler(ClickKey, value);
            }
        }

        protected virtual void OnClick(EventArgs e)//定義Click事件處理函數
        {
            EventHandler clickEventDelegate =
               (EventHandler)Events[ClickKey];
            if (clickEventDelegate != null)
            {
                clickEventDelegate(this, e);
            }
        }

        public void RaisePostBackEvent(string argument)
        {

            OnClick(EventArgs.Empty);
        }

        override protected void Render(HtmlTextWriter writer)
        {
            base.Render(writer);
            Page.VerifyRenderingInServerForm(this);

            if (Display == ButtonDisplay.Button)
            {
                writer.Write("<INPUT type=\"submit\"");
                writer.Write(" name=\"" + this.UniqueID + "\"");
                writer.Write(" id=\"" + this.UniqueID + "\"");
                writer.Write(" value=\"" + Text + "\"");
                writer.Write(" />");
            }
            else if (Display == ButtonDisplay.Hyperlink)
            {
                writer.Write("<A href=\"");
                writer.Write(Page.ClientScript.GetPostBackClientHyperlink(this, ""));
                writer.Write("\">" + Text + "</A>");
            }
        }

        public enum ButtonDisplay
        {
            Button = 0,
            Hyperlink = 1
        }

    }

    
}

根據屬性Display的屬性的設置，對事件的回發進行控制，如果是Hyperlink則是客戶端回發機制。

小結：新手在對事件的回發上可能會迷糊，但是不要緊，慢慢的理解。簡單的理解事件的回發就是我們點擊一個按鈕發生的事件，而這個事件的處理ASP.NET給我們提供了兩種方式。更多ASP.NET服務器控件事件可以參考：

ASP.NET 服務器控件事件模型

 ASP.NET 網頁中的服務器事件處理

轉載地址：http://www.pin5i.com/showtopic-24504.html

C# 封裝控件學習（3）

C# 封裝控件學習（1）

做網站經常要用正則表達式

C# 封裝控件學習（2）

extjs PagingToolbar 源碼

C# 封裝控件學習（4）

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結

C# 封裝控件 學習（3）

C# 封裝控件學習（3）