ImageButton.TagKey プロパティ
ImageButton コントロールに対応する HtmlTextWriterTag 値を取得します。
名前空間: 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 列挙値。
解説
TagKey プロパティは、カスタム クラスを ImageButton コントロールから派生させる場合に、主に開発者によって使用されます。
TagKey プロパティを使用して、ImageButton コントロールに関連付けられた HtmlTextWriterTag 値を確認します。このプロパティは基本実装をオーバーライドし、常に HtmlTextWriterTag.Input が返されるようにします。
使用例
カスタムの ImageButton コントロールの TagKey メソッドをオーバーライドして、常に Input タグが返されるようにする方法のコード例を次に示します。
.gif) メモ : |
|---|
次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルの最初の部分は、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。2 番目の部分は .cs ファイル (C# の場合) または .vb ファイル (Visual Basic の場合) に入れる必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ 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 ImageButton - TagKey - VB.NET Example</title>
<script runat="server">
Sub ImageButton1_Command(sender As Object, e As CommandEventArgs)
' Redirect to the Microsoft home page.
Response.Redirect("https://www.microsoft.com/")
End Sub
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom ImageButton - TagKey - VB.NET Example</h3>
<aspSample:CustomImageButtonTagKey id="ImageButton1" runat="server"
OnCommand="ImageButton1_Command" AlternateText="Microsoft Home"
ImageUrl="https://www.microsoft.com/homepage/gif/bnr-microsoft.gif" />
</form>
</body>
</html>
...
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomImageButtonTagKey
Inherits System.Web.UI.WebControls.ImageButton
Protected Overrides ReadOnly Property TagKey() As System.Web.UI.HtmlTextWriterTag
Get
' Specify that only the Input HTML tag can be passed to the HtmlTextWriter.
Return System.Web.UI.HtmlTextWriterTag.Input
End Get
End Property
End Class
<%@ 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 ImageButton - TagKey - C# Example</title>
<script runat="server">
void ImageButton1_Command(Object sender, CommandEventArgs e)
{
// Redirect to the Microsoft home page.
Response.Redirect("https://www.microsoft.com/");
}
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom ImageButton - TagKey - C# Example</h3>
<aspSample:CustomImageButtonTagKey
id="ImageButton1"
runat="server"
OnCommand="ImageButton1_Command"
AlternateText="Microsoft Home"
ImageUrl="https://www.microsoft.com/homepage/gif/bnr-microsoft.gif" />
</form>
</body>
</html>
...
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomImageButtonTagKey : System.Web.UI.WebControls.ImageButton
{
protected override System.Web.UI.HtmlTextWriterTag TagKey
{
get
{
// Specify that only the Input HTML tag can be passed to the HtmlTextWriter.
return System.Web.UI.HtmlTextWriterTag.Input;
}
}
}
}
<%@ 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 ImageButton - TagKey - VJ# Example</title>
<script runat="server">
void ImageButton1_Command(Object sender, CommandEventArgs e)
{
// Redirect to the Microsoft home page.
get_Response().Redirect("https://www.microsoft.com/");
} //ImageButton1_Command
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom ImageButton - TagKey - VJ# Example</h3>
<aspSample:CustomImageButtonTagKey
id="ImageButton1"
runat="server"
OnCommand="ImageButton1_Command"
AlternateText="Microsoft Home"
ImageUrl="https://www.microsoft.com/homepage/gif/bnr-microsoft.gif" />
</form>
</body>
</html>
...
package Samples.AspNet.JSL.Controls;
public class CustomImageButtonTagKey
extends System.Web.UI.WebControls.ImageButton
{
/** @property
*/
protected System.Web.UI.HtmlTextWriterTag get_TagKey()
{
// Specify that only the Input HTML tag can be passed to the
// HtmlTextWriter.
return System.Web.UI.HtmlTextWriterTag.Input;
} //get_TagKey
} //CustomImageButtonTagKey
プラットフォーム
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
参照
関連項目
ImageButton クラス
ImageButton メンバ
System.Web.UI.WebControls 名前空間
HtmlTextWriterTag