TextBox.TagKey プロパティ

2007-06-26

テキストボックスコントロールの HTML タグを取得します。このプロパティは保護されています。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)

構文

'宣言
Protected Overrides ReadOnly Property TagKey As HtmlTextWriterTag
'使用
Dim value As HtmlTextWriterTag

value = Me.TagKey

protected override HtmlTextWriterTag TagKey { get; }

protected:
virtual property HtmlTextWriterTag TagKey {
    HtmlTextWriterTag get () override;
}

/** @property */
protected HtmlTextWriterTag get_TagKey ()

protected override function get TagKey () : HtmlTextWriterTag

適用できません。

プロパティ値

テキストボックスが複数行テキストボックスである場合は HtmlTextWriterTag.Textarea。それ以外の場合は Input。

使用例

Tagkey プロパティを使用して、カスタムテキストボックスを作成する方法を次のコード例に示します。

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

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

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ 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>Custom TextBox - TagKey - VB.NET Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TextBox - TagKey - VB.NET Example</h3>
            
            <aspSample:CustomTextBoxTagKey 
              id="TextBox1" 
              runat="server">Hello World!
          </aspSample:CustomTextBoxTagKey>
          
        </form>
    </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ 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>Custom TextBox - TagKey - C# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TextBox - TagKey - C# Example</h3>
            
            <aspSample:CustomTextBoxTagKey 
              id="TextBox1" 
              runat="server">Hello World!
            </aspSample:CustomTextBoxTagKey>
            
        </form>
    </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" 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>Custom TextBox - TagKey - VJ# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TextBox - TagKey - VJ# Example</h3>
            
            <aspSample:CustomTextBoxTagKey 
              id="TextBox1" 
              runat="server"
              text="Hello World!">
            </aspSample:CustomTextBoxTagKey>
            
        </form>
    </body>
</html>

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomTextBoxTagKey
        Inherits System.Web.UI.WebControls.TextBox

        Protected Overrides ReadOnly Property TagKey() As System.Web.UI.HtmlTextWriterTag
            Get
                ' If the TextMode is MultiLine, return a Textarea tag, else return an Input tag.
                If Me.TextMode = System.Web.UI.WebControls.TextBoxMode.MultiLine Then
                    Return System.Web.UI.HtmlTextWriterTag.Textarea
                Else
                    Return System.Web.UI.HtmlTextWriterTag.Input
                End If
            End Get
        End Property
    End Class
End Namespace

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomTextBoxTagKey : System.Web.UI.WebControls.TextBox
  {
    protected override System.Web.UI.HtmlTextWriterTag TagKey
    {
      get 
      {
        // If the TextMode is MultiLine, return a Textarea tag, 
        // else return an Input tag.
        if (this.TextMode == System.Web.UI.WebControls.TextBoxMode.MultiLine)
        {
          return System.Web.UI.HtmlTextWriterTag.Textarea;
        }
        else
        {
          return System.Web.UI.HtmlTextWriterTag.Input;
        }
      }
    }
  }
}

package Samples.AspNet.JSL.Controls; 

public class CustomTextBoxTagKey
    extends System.Web.UI.WebControls.TextBox
{
    /** @property 
     */
    protected System.Web.UI.HtmlTextWriterTag get_TagKey()
    {
        // If the TextMode is MultiLine, return a Textarea tag, 
        // else return an Input tag.
        if (this.get_TextMode().Equals(System.Web.UI.WebControls.
            TextBoxMode.MultiLine)) {
            return System.Web.UI.HtmlTextWriterTag.Textarea;
        }
        else {
            return System.Web.UI.HtmlTextWriterTag.Input;
        }
    } //get_TagKey
} //CustomTextBoxTagKey

プラットフォーム

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

参照

その他の技術情報

TextBox Web サーバーコントロール
 スクリプトによる攻略の概要