前兩篇介紹了服務器控件的基本顯示,屬性的設定,繼承Webcontrol開發控件等內容,這篇介紹下定制服務器控件的事件的處理和回傳數據的處理。
當
ASP.NET
頁面處理回傳到服務器端的表單時,兩種信息會傳遞給頁面中的控件:
回傳事件,如
Button
一類控件觸發的回傳,會引發服務器端事件;
回傳數據:是
Web
表單中包含的數據,該數據是在
Web
表單提交到服務器端時傳遞給如
TextBox
一類的控件。
處理回傳數據
PostBack(回傳):ASP.NET控件提交表單到服務器端,將信息從瀏覽器傳遞到服務器端的過程。
我們可能經常會在Page_Load事件中寫這樣的代碼:
<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->
protected
void
Page_Load(
object
sender,EventArgse)
{
if
(
!
IsPostBack)
{
.
}
}
但是初學的時候我們很少回去問,為什么要寫這段代碼,只知道這么寫就是對的。其實這就是數據回傳的一個表現,通過該值指示該頁是否正為響應客戶端回發而加載。
ASP.ENT服務器控件處理回傳數據,基本上完成以下兩個工作:
-->繼承并實現IPostBackDataHandler接口的
-->實現RaisePostDataChangedEvent方法,處理回發數據
通過例子說明一下,這里創建一個自己的文本框:創建一個ASP.NET服務器控件項目(MyTextBox)
Code
<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->
namespace
NewTextBox
{
[DefaultProperty(
"
Text
"
)]
[ToolboxData(
"
<{0}:NewTextBoxrunat=server></{0}:NewTextBox>
"
)]
public
class
NewTextBox:WebControl,IPostBackDataHandler
{
public
event
EventHandlerTextChanged;
public
string
ViewText
//
定義顯示文字屬性
{
get
{
if
(ViewState[
"
Text
"
].Equals(
null
))
{
return
String.Empty;
}
else
{
return
ViewState[
"
Text
"
].ToString();
}
}
set
{
ViewState[
"
Text
"
]
=
value;
}
}
protected
override
HtmlTextWriterTagTagKey
//
向頁面中添加文本框
{
get
{
return
HtmlTextWriterTag.Input;
}
}
protected
override
void
AddAttributesToRender(HtmlTextWriterwriter)
{
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.NameValueCollectionpostCollection)
//
表單域的值和控件的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);
}
}
}
測試一下:
<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->
protected
void
Button1_Click(
object
sender,EventArgse)
{
Label1.Text
=
NewTextBox1.ViewText;
}
只有當文本框中是文字發生變化是,才會引起數據的回發并從新獲得數據。(控件拖到頁面時,要給viewText賦值)
處理回發事件
ASP.NET服務器控件處理回發事件,基本上需要完成以下兩個工作:
-->繼承并實現IPostBackEventHandler接口的
-->實現RaisePostBackEvent方法,處理回發事件
Button控件繼承IPostBackEventHandler接口(所有的按鈕控件,ImageButton,LinkButtton都繼承了這個接口)。IPostBackEventHandler接口專門定義了處理回發事件的方法,如果自定義控件需要處理回發事件,你就需要繼承IPostBackEventHandler接口。
通過例子說明一下,這里我們定制一個自己的按鈕:創建一個ASP.NET服務器控件項目(MyButton)
Code
<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->
namespace
MyButton
{
[DefaultProperty(
"
Text
"
)]
[ToolboxData(
"
<{0}:MyButtonrunat=server></{0}:MyButton>
"
)]
public
class
MyButton:WebControl,IPostBackEventHandler
{
private
static
readonly
object
ClickKey
=
new
object
();
public
event
EventHandlerClick
//
定義事件的委托
{
add
{
Events.AddHandler(ClickKey,value);
}
remove
{
Events.RemoveHandler(ClickKey,value);
}
}
protected
virtual
void
OnClick(EventArgse)
//
定義單擊事件的處理程序
{
EventHandlerclickEventDelegate
=
(EventHandler)Events[ClickKey];
if
(clickEventDelegate
!=
null
)
{
clickEventDelegate(
this
,e);
}
}
public
void
RaisePostBackEvent(
string
eventArgument)
//
處理回發事件
{
OnClick(
new
EventArgs());
}
protected
override
void
RenderContents(HtmlTextWriteroutput)
{
output.Write(
"
<INPUTTYPE=submitname=
"
+
this
.UniqueID
+
"
Value='這是自己定制的按鈕!'/>
"
);
}
}
}
測試一下:
<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->
protected
void
MyButton1_Click(
object
sender,EventArgse)
{
Label1.Text
=
"
HelloWorld!!!!!!!!!
"
;
}
按鈕的事件回發處理成功。
客戶端回發事件
在asp.net2.0中,Button 控件多了一個UseSubmitBehavior 屬性,指示 Button 控件使用客戶端瀏覽器的提交機制(客戶端回發)還是 ASP.NET 回發機制,默認采用ASP.NET回發機制,如果設置為false的話,則需要調用GetPostBackEventReference 方法來返回 Button 的客戶端回發事件。
當設置UseSubmitBehavior 屬性為flase時,運行頁面時,則會發現一段自動生成的javascript代碼(查看源文件)
Code
<!--<br /><br />Code highlighting produced by Actipro CodeHighlighter (freeware)<br />http://www.CodeHighlighter.com/<br /><br />-->
<
scripttype
=
"
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>
這里我們創建一個按鈕,根據屬性的設定,更改其事件回發的方式:
Code
<!--<br /><br />Code highlighting produced by Actipro CodeHighlighter (freeware)<br />http://www.CodeHighlighter.com/<br /><br />-->
namespace
MyLinkButton
{
[DefaultProperty(
"
Text
"
)]
[ToolboxData(
"
<{0}:MyLinkButtonrunat=server></{0}:MyLinkButton>
"
)]
public
class
MyLinkButton:WebControl,IPostBackEventHandler
{
public
virtual
ButtonDisplayDisplay
{
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
EventHandlerClick
//
定義委托
{
add
{
Events.AddHandler(ClickKey,value);
}
remove
{
Events.RemoveHandler(ClickKey,value);
}
}
protected
virtual
void
OnClick(EventArgse)
//
定義Click事件處理函數
{
EventHandlerclickEventDelegate
=
(EventHandler)Events[ClickKey];
if
(clickEventDelegate
!=
null
)
{
clickEventDelegate(
this
,e);
}
}
public
void
RaisePostBackEvent(
string
argument)
{
OnClick(EventArgs.Empty);
}
override
protected
void
Render(HtmlTextWriterwriter)
{
base
.Render(writer);
Page.VerifyRenderingInServerForm(
this
);
if
(Display
==
ButtonDisplay.Button)
{
writer.Write(
"
<INPUTtype=\
"
submit\
""
);
writer.Write(
"
name=\
""
+this.UniqueID+
"
\
""
);
writer.Write(
"
id=\
""
+this.UniqueID+
"
\
""
);
writer.Write(
"
value=\
""
+Text+
"
\
""
);
writer.Write(
"
/>
"
);
}
else
if
(Display
==
ButtonDisplay.Hyperlink)
{
writer.Write(
"
<Ahref=\
""
);
writer.Write(Page.ClientScript.GetPostBackClientHyperlink(
this
,
""
));
writer.Write(
"
\
"
>
"
+Text+
"
</
A
>
"
);
}
}
public
enum
ButtonDisplay
{
Button
=
0
,
Hyperlink
=
1
}
}
}
根據屬性Display的屬性的設置,對事件的回發進行控制,如果是Hyperlink則是客戶端回發機制。
小結:新手在對事件的回發上可能會迷糊,但是不要緊,慢慢的理解。簡單的理解事件的回發就是我們點擊一個按鈕發生的事件,而這個事件的處理ASP.NET給我們提供了兩種方式。更多ASP.NET服務器控件事件可以參考:
http://msdn.microsoft.com/zh-cn/library/cc437696(VS.71).aspx
http://msdn.microsoft.com/zh-cn/library/xax2hw3x.aspx
寫的不好,希望能對新手有幫助。
ASP.NET服務器控件開發(3)--事件和回傳數據的處理