WebControl.Attributes プロパティ

[アーティクル]
06/26/2007

コントロールのプロパティに対応しない任意の属性 (表示専用) のコレクションを取得します。

名前空間: 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 サーバーコントロールに関連付けられた属性をプログラムで制御できます。コレクションに属性を追加したり、コレクションから属性を削除したりできます。

メモ :
このプロパティは、ブラウザの設定に関係なく、コントロールの開始タグで宣言されたコレクション内のすべての属性を使用して表示されます。表示されるすべての属性をサポートしないブラウザもあります。サポートされない属性は、通常、ブラウザで無視されます。

メモ :
Attributes コレクションを使用してクライアント側のスクリプトを WebControl インスタンスに追加することはできません。クライアント側のスクリプトを追加するには、Page コントロールの ClientScript プロパティを使用します。

使用例

WebControl の Attributes プロパティを使用して、TextBox コントロールがフォーカスを失ったときに、JavaScript コマンドを実行する方法の例を次に示します。

メモ :
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

セキュリティに関するメモ :
この例には、ユーザー入力を受け付けるテキストボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。詳細については、「スクリプトによる攻略の概要」を参照してください。

この例には、ユーザー入力を受け付けるテキストボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、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

参照

その他の技術情報

Web サーバーコントロール構文
 ASP.NET カスタムサーバーコントロールの開発

次の方法で共有