HtmlTextArea.OnServerChange(EventArgs) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ServerChange コントロールのHtmlTextArea イベントを発生させます。 これにより、イベントのカスタム ハンドラーを提供できます。
protected:
virtual void OnServerChange(EventArgs ^ e);protected virtual void OnServerChange(EventArgs e);abstract member OnServerChange : EventArgs -> unit
override this.OnServerChange : EventArgs -> unitProtected Overridable Sub OnServerChange (e As EventArgs)パラメーター
例
次のコード例では、 ServerChange イベントのカスタム イベント ハンドラーを指定して作成する方法を示します。 HtmlTextArea コントロールに入力された値が 20 文字を超えると、メッセージが表示されます。
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Server_Change(Object sender, EventArgs e)
{
// The ServerChange event is commonly used for data validation.
// This method determines whether the comment entered into the
// HtmlTextArea control is longer than 20 characters.
if (TextArea1.Value.Length > 20)
Span1.InnerHtml = "Your comment cannot exceed 20 characters.";
else
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments: <br />
<textarea rows="2" cols="20" id="TextArea1"
onserverchange="Server_Change"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Server_Change(ByVal sender As Object, ByVal e As EventArgs)
' The ServerChange event is commonly used for data validation.
' This method determines whether the comment entered into the
' HtmlTextArea control is longer than 20 characters.
If TextArea1.Value.Length > 20 Then
Span1.InnerHtml = "Your comment cannot exceed 20 characters."
Else
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments: <br />
<textarea rows="2" cols="20" id="TextArea1"
onserverchange="Server_Change"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Server_Change(Object sender, EventArgs e)
{
// The ServerChange event is commonly used for data validation.
// This method determines whether the comment entered into the
// HtmlTextArea control is longer than 20 characters.
if (TextArea1.Value.Length > 20)
{
Span1.InnerHtml = "Your comment cannot exceed 20 characters.";
}
else
{
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value;
}
}
void Page_Load(Object sender, EventArgs e)
{
// Create an EventHandler delegate for the method you want to
// handle the event, and then add it to the list of methods
// called when the event is raised.
TextArea1.ServerChange +=
new System.EventHandler(this.Server_Change);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments (20 or fewer characters): <br />
<textarea rows="2" cols="20" id="TextArea1"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Server_Change(ByVal sender As Object, ByVal e As EventArgs)
' The ServerChange event is commonly used for data validation.
' This method determines whether the comment entered into the
' HtmlTextArea control is longer than 20 characters.
If TextArea1.Value.Length > 20 Then
Span1.InnerHtml = "Your comment cannot exceed 20 characters."
Else
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value
End If
End Sub
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Create an EventHandler delegate for the method you want to
' handle the event, and then add it to the list of methods
' called when the event is raised.
AddHandler TextArea1.ServerChange, AddressOf Server_Change
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments (20 or fewer characters): <br />
<textarea rows="2" cols="20" id="TextArea1"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server" />
</form>
</body>
</html>
注釈
ServerChange イベントは、HtmlTextArea コントロールのコンテンツがサーバーへの投稿間で変化したときに発生します。
Note
このイベントは、ユーザーがサーバーへの投稿を開始したとき ( submit ボタンをクリックするなど) にのみ発生します。 このイベントでは、サーバーへの投稿は発生しません。
Note
ServerChange イベントが正常に動作するためには、コントロールで viewstate が有効になっている必要があります。
このイベントは、ユーザーがコントロール内のテキストを更新するときに、 HtmlTextArea コントロールのデータ検証を実行するために一般的に使用されます。
イベントを発生させると、デリゲートを介してイベント ハンドラーが呼び出されます。 詳細については、「イベントの 処理と発生」を参照してください。
OnServerChange メソッドでは、デリゲートをアタッチせずに、派生クラスでイベントを処理することもできます。 これは、派生クラスでイベントを処理するために推奨される手法です。
注意 (継承者)
派生クラスで OnServerChange(EventArgs) をオーバーライドする場合は、登録されているデリゲートがイベントを受け取るように、基底クラスの OnServerChange(EventArgs) メソッドを必ず呼び出してください。