ImageButton.TagKey-Eigenschaft

Artikel
08/20/2007

Ruft den HtmlTextWriterTag-Wert ab, der dem ImageButton-Steuerelement entspricht.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overrides ReadOnly Property TagKey As HtmlTextWriterTag
'Usage
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

Eigenschaftenwert

Ein HtmlTextWriterTag-Enumerationswert.

Hinweise

Die TagKey-Eigenschaft wird primär von Steuerelemententwicklern beim Ableiten einer benutzerdefinierten Klasse von dem ImageButton-Steuerelement verwendet.

Mit der TagKey-Eigenschaft können Sie den HtmlTextWriterTag-Wert bestimmen, der einem ImageButton-Steuerelement zugeordnet ist. Diese Eigenschaft überschreibt die Basisimplementierung, damit immer HtmlTextWriterTag.Input zurückgegeben wird.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der TagKey-Methode in einem benutzerdefinierten ImageButton-Steuerelement veranschaulicht, sodass es immer ein Eingabetag zurückgibt.

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Der erste Teil des Codebeispiels muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Der zweite Teil muss sich in einer CS-Datei (für C#) oder einer VB-Datei (für Visual Basic) befinden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
    <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" %>
<HTML>
    <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" %>
<HTML>
    <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

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ImageButton-Klasse
ImageButton-Member
System.Web.UI.WebControls-Namespace
HtmlTextWriterTag

Weitere Ressourcen

Deklarative Syntax des ImageButton-Webserversteuerelements
Übersicht über die Button-Webserversteuerelemente

Freigeben über