WebControl.Attributes プロパティ
コントロールのプロパティに対応しない任意の属性 (表示専用) のコレクションを取得します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public ReadOnly Property Attributes As AttributeCollection
'使用
Dim instance As WebControl
Dim value As AttributeCollection
value = instance.Attributes
public AttributeCollection Attributes { get; }
public:
property AttributeCollection^ Attributes {
AttributeCollection^ get ();
}
/** @property */
public AttributeCollection get_Attributes ()
public function get Attributes () : AttributeCollection
適用できません。
プロパティ値
名前と値の組み合わせの AttributeCollection。
解説
Attributes コレクションには、Web サーバー コントロールの開始タグで宣言されたすべての属性のコレクションが格納されます。これによって、Web サーバー コントロールに関連付けられた属性をプログラムで制御できます。コレクションに属性を追加したり、コレクションから属性を削除したりできます。
.gif) メモ : |
|---|
このプロパティは、ブラウザの設定に関係なく、コントロールの開始タグで宣言されたコレクション内のすべての属性を使用して表示されます。表示されるすべての属性をサポートしないブラウザもあります。サポートされない属性は、通常、ブラウザで無視されます。 |
| メモ : |
|---|
Attributes コレクションを使用してクライアント側のスクリプトを WebControl インスタンスに追加することはできません。クライアント側のスクリプトを追加するには、Page コントロールの ClientScript プロパティを使用します。 |
使用例
WebControl の Attributes プロパティを使用して、TextBox コントロールがフォーカスを失ったときに、JavaScript コマンドを実行する方法の例を次に示します。
| メモ : |
|---|
次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
.gif) セキュリティに関するメモ : |
|---|
この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Attributes Property of a Web Control</title>
<script language="VB" runat="server">
Sub Page_Load(sender As Object, e As EventArgs)
TextBox1.Attributes("onblur") = "javascript:alert('Hello! Focus lost from text box!!');"
End Sub
</script>
</head>
<body>
<h3>Attributes Property of a Web Control</h3>
<form id="form1" runat="server">
<asp:TextBox id="TextBox1" columns="54"
Text="Click here and then tap out of this text box"
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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Attributes Property of a Web Control</title>
<script language="C#" runat="server">
void Page_Load(Object sender, EventArgs e) {
TextBox1.Attributes["onblur"]="javascript:alert('Hello! Focus lost from text box!!');";
}
</script>
</head>
<body>
<h3>Attributes Property of a Web Control</h3>
<form id="form1" runat="server">
<asp:TextBox id="TextBox1" columns="54"
Text="Click here and then tap out of this text box"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="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>Attributes Property of a Web Control</title>
<script language="JSCRIPT" runat="server">
function Page_Load(sender : Object, e : EventArgs){
TextBox1.Attributes("onblur") = "javascript:alert('Focus lost from text box!!');"
}
</script>
</head>
<body>
<h3>Attributes Property of a Web Control</h3>
<form id="form1" runat="server">
<asp:TextBox id="TextBox1" columns="54"
Text="Click here and then tab out of this text box"
runat="server"/>
</form>
</body>
</html>
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
参照
関連項目
WebControl クラス
WebControl メンバ
System.Web.UI.WebControls 名前空間
System.Web.UI.AttributeCollection
System.Web.UI.ClientScriptManager