ImageButton Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein Steuerelement, das ein Bild anzeigt und auf Mausklicks auf das Bild reagiert.

public ref class ImageButton : System::Web::UI::WebControls::Image, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler

public ref class ImageButton : System::Web::UI::WebControls::Image, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControl

public class ImageButton : System.Web.UI.WebControls.Image, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler

public class ImageButton : System.Web.UI.WebControls.Image, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControl

type ImageButton = class
    inherit Image
    interface IPostBackDataHandler
    interface IPostBackEventHandler

type ImageButton = class
    inherit Image
    interface IPostBackDataHandler
    interface IPostBackEventHandler
    interface IButtonControl

Public Class ImageButton
Inherits Image
Implements IPostBackDataHandler, IPostBackEventHandler

Public Class ImageButton
Inherits Image
Implements IButtonControl, IPostBackDataHandler, IPostBackEventHandler

Vererbung: Object

Control

WebControl

Image
ImageButton

Implementiert: IPostBackDataHandler IPostBackEventHandler IButtonControl

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen eines ImageButton Steuerelements, das die Koordinaten anzeigt, auf die ein Bild geklickt wird.

Hinweis

Im folgenden Codebeispiel wird das Codemodell mit einer Datei verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die über eine .aspx Erweiterung verfügt. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Forms Page Code Model.

<%@ 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>ImageButton Sample</title>
<script language="C#" runat="server">

      void ImageButton_Click(object sender, ImageClickEventArgs e) 
      {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + 
                       e.X.ToString() + ", " + e.Y.ToString() + ")";
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</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>ImageButton Sample</title>
<script language="VB" runat="server">

      Sub ImageButton_Click(sender As Object, e As ImageClickEventArgs) 
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" & _ 
                       e.X.ToString() & ", " & e.Y.ToString() & ")"
      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>

Hinweise

In diesem Thema:

Introduction
Bestimmen der Stelle, an der der Benutzer geklickt hat
ImageButton-Steuerelemente und -Überprüfung
Zugänglichkeit
Deklarative Syntax

Einführung

Verwenden Sie das ImageButton Steuerelement, um ein Bild anzuzeigen, das auf Mausklicks reagiert.

Sowohl die Ereignisse als auch die Click Command Ereignisse werden ausgelöst, wenn auf das ImageButton Steuerelement geklickt wird.

Sie können den OnCommand Ereignishandler verwenden, damit sich das ImageButton Steuerelement wie eine Befehlsschaltfläche verhält. Ein Befehlsname kann dem Steuerelement mithilfe der CommandName Eigenschaft zugeordnet werden. Auf diese Weise können mehrere ImageButton Steuerelemente auf derselben Webseite platziert werden. Der Wert der CommandName Eigenschaft kann dann programmgesteuert im OnCommand Ereignishandler identifiziert werden, um die entsprechende Aktion zu bestimmen, die ausgeführt werden soll, wenn auf jedes ImageButton Steuerelement geklickt wird. Die CommandArgument Eigenschaft kann auch verwendet werden, um zusätzliche Informationen zum Befehl zu übergeben, z. B. zum Angeben aufsteigender Reihenfolge.

Die Verwendung des Steuerelements ähnelt der ImageButton Verwendung des ASP.NET-Steuerelements Button . Weitere Informationen finden Sie unter Button Web Server Controls Content Map. und die Klassenübersicht für das Button Steuerelement.

Bestimmen der Stelle, an der der Benutzer geklickt hat

Mithilfe des OnClick Ereignishandlers können Sie programmgesteuert die Koordinaten bestimmen, auf die das Bild geklickt wird. Anschließend können Sie eine Antwort basierend auf den Werten der Koordinaten codiert werden. Beachten Sie, dass sich der Ursprung (0, 0) in der oberen linken Ecke des Bilds befindet.

ImageButton-Steuerelemente und -Überprüfung

Standardmäßig wird die Seitenüberprüfung ausgeführt, wenn auf ein ImageButton Steuerelement geklickt wird. Die Seitenüberprüfung bestimmt, ob die Eingabesteuerelemente, die einem Überprüfungssteuerelement auf der Seite zugeordnet sind, alle durch das Überprüfungssteuerelement angegebenen Gültigkeitsprüfungsregeln bestehen. Um zu verhindern, dass die Seitenüberprüfung auftritt, legen Sie die CausesValidation Eigenschaft auf false.

Zugänglichkeit

Informationen zum Konfigurieren dieses Steuerelements, sodass es Markup generiert, das den Barrierefreiheitsstandards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und ASP.NET Steuerelemente und Barrierefreiheit.

Deklarative Syntax

<asp:ImageButton
    AccessKey="string"
    AlternateText="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    DescriptionUrl="uri"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|
        AbsBottom|AbsMiddle|TextTop"
    ImageUrl="uri"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Konstruktoren

Name	Beschreibung
ImageButton()	Initialisiert eine neue Instanz der ImageButton-Klasse.

Eigenschaften

Name	Beschreibung
AccessKey	Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können. (Geerbt von WebControl)
Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control)
AlternateText	Ruft den alternativen Text ab, der Image im Steuerelement angezeigt wird, wenn das Bild nicht verfügbar ist, oder legt den alternativen Text fest. Browser, die das QuickInfo-Feature unterstützen, zeigen diesen Text als QuickInfo an. (Geerbt von Image)
AppRelativeTemplateSourceDirectory	Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control)
Attributes	Ruft die Auflistung beliebiger Attribute (nur für das Rendern) ab, die nicht den Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl)
BackColor	Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements. (Geerbt von WebControl)
BindingContainer	Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control)
BorderColor	Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Geerbt von WebControl)
BorderStyle	Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements. (Geerbt von WebControl)
BorderWidth	Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl)
CausesValidation	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Überprüfung ausgeführt wird, wenn auf das ImageButton Steuerelement geklickt wird.
ChildControlsCreated	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control)
ClientID	Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control)
ClientIDMode	Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
ClientIDSeparator	Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
CommandArgument	Dient zum Abrufen oder Festlegen eines optionalen Arguments, das zusätzliche Informationen zur CommandName Eigenschaft bereitstellt.
CommandName	Dient zum Abrufen oder Festlegen des Befehlsnamens, der dem ImageButton Steuerelement zugeordnet ist.
Context	Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control)
Controls	Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von Control)
ControlStyle	Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
ControlStyleCreated	Ruft einen Wert ab, der angibt, ob ein Style Objekt für die ControlStyle Eigenschaft erstellt wurde. Diese Eigenschaft wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
CssClass	Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die vom Webserversteuerelement auf dem Client gerendert wird. (Geerbt von WebControl)
DataItemContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control)
DataKeysContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control)
DescriptionUrl	Dient zum Abrufen oder Festlegen des Speicherorts auf eine detaillierte Beschreibung für das Bild. (Geerbt von Image)
DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control)
Enabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob auf den ImageButton Server geklickt werden kann, um einen Beitrag zurück auf den Server auszuführen.
Enabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von Image)
EnableTheming	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von WebControl)
EnableViewState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control)
Events	Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control)
Font	Ruft die Schriftarteigenschaften für den Text ab, der dem Steuerelement zugeordnet ist. (Geerbt von Image)
ForeColor	Ruft die Vordergrundfarbe (in der Regel die Farbe des Texts) des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl)
GenerateEmptyAlternateText	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement ein alternatives Text-Attribut für einen leeren Zeichenfolgenwert generiert.
HasAttributes	Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt hat. (Geerbt von WebControl)
HasChildViewState	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control)
Height	Ruft die Höhe des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl)
ID	Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control)
IdSeparator	Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control)
ImageAlign	Dient zum Abrufen oder Festlegen der Ausrichtung des Image Steuerelements in Bezug auf andere Elemente auf der Webseite. (Geerbt von Image)
ImageUrl	Dient zum Abrufen oder Festlegen der URL, die den Pfad zu einem Bild bereitstellt, das Image im Steuerelement angezeigt werden soll. (Geerbt von Image)
IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control)
IsEnabled	Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von WebControl)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control)
IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control)
LoadViewStateByID	Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control)
NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control)
OnClientClick	Ruft das clientseitige Skript ab, das ausgeführt wird, wenn das Ereignis eines ImageButton Steuerelements Click ausgelöst wird, oder legt dieses fest.
Page	Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control)
Parent	Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control)
PostBackUrl	Ruft die URL der Seite ab, auf die die aktuelle Seite gesendet werden soll, wenn auf das Steuerelement geklickt wird, oder legt diese ImageButton fest.
RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control)
Site	Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control)
SkinID	Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von WebControl)
Style	Ruft eine Auflistung von Textattributen ab, die als Formatvorlagenattribute auf dem äußeren Tag des Webserversteuerelements gerendert werden. (Geerbt von WebControl)
SupportsDisabledAttribute	Ruft einen Wert ab, der angibt, ob das Steuerelement das `disabled` Attribut des gerenderten HTML-Elements auf "disabled" festlegen soll, wenn die Eigenschaft des Steuerelements IsEnabled ist `false`.
TabIndex	Dient zum Abrufen oder Festlegen des Registerkartenindex des Webserversteuerelements. (Geerbt von WebControl)
TagKey	Ruft den HtmlTextWriterTag Wert ab, der dem ImageButton Steuerelement entspricht.
TagName	Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
TemplateControl	Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control)
TemplateSourceDirectory	Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control)
Text	Dient zum Abrufen oder Festlegen des Werts der Eigenschaft des ImageButton Steuerelements AlternateText .
ToolTip	Ruft den Text ab, der angezeigt wird, wenn der Mauszeiger auf das Webserversteuerelement zeigt, oder legt diesen fest. (Geerbt von WebControl)
UniqueID	Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control)
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control)
ValidationGroup	Dient zum Abrufen oder Festlegen der Gruppe von Steuerelementen, für die das ImageButton Steuerelement eine Überprüfung verursacht, wenn es wieder auf dem Server veröffentlicht wird.
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control)
ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control)
ViewStateMode	Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control)
Width	Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements. (Geerbt von WebControl)

Methoden

Name	Beschreibung
AddAttributesToRender(HtmlTextWriter)	Fügt dem Ausgabedatenstrom die Attribute für ImageButton das Rendern auf dem Client hinzu.
AddedControl(Control, Int32)	Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control)
AddParsedSubObject(Object)	Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control)
ApplyStyle(Style)	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wobei alle vorhandenen Formatvorlagenelemente des Steuerelements überschrieben werden. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
ApplyStyleSheetSkin(Page)	Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control)
BeginRenderTracing(TextWriter, Object)	Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
BuildProfileTree(String, Boolean)	Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control)
ClearCachedClientID()	Legt den zwischengespeicherten ClientID Wert auf `null`. (Geerbt von Control)
ClearChildControlState()	Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildState()	Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildViewState()	Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearEffectiveClientIDMode()	Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control)
CopyBaseAttributes(WebControl)	Kopiert die Eigenschaften, die nicht vom Objekt aus dem Style angegebenen Webserversteuerelement in das Webserversteuerelement gekapselt werden, von dem diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
CreateChildControls()	Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control)
CreateControlCollection()	Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält. (Geerbt von Control)
CreateControlStyle()	Erstellt das Formatvorlagenobjekt, das intern von der WebControl Klasse verwendet wird, um alle formatbezogenen Eigenschaften zu implementieren. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
DataBind()	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control)
DataBind(Boolean)	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control)
DataBindChildren()	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
Dispose()	Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control)
EndRenderTracing(TextWriter, Object)	Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
EnsureChildControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control)
EnsureID()	Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen `id` und einer ganzzahligen Zahl, die `pathOffset` im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen. (Geerbt von Control)
FindControl(String)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen `id` Parameter. (Geerbt von Control)
Focus()	Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control)
GetDesignModeState()	Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetPostBackOptions()	Erstellt ein PostBackOptions Objekt, das das Postbackverhalten des ImageButton Steuerelements darstellt.
GetRouteUrl(Object)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(String, Object)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetUniqueIDRelativeTo(Control)	Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control)
HasControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control)
HasEvents()	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control)
IsLiteralContent()	Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control)
LoadControlState(Object)	Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control)
LoadPostData(String, NameValueCollection)	Verarbeitet bereitgestellte Daten für das ImageButton Steuerelement.
LoadViewState(Object)	Stellt Ansichtsstatusinformationen aus einer vorherigen Anforderung wieder her, die mit der SaveViewState() Methode gespeichert wurde. (Geerbt von WebControl)
MapPathSecure(String)	Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MergeStyle(Style)	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
OnBubbleEvent(Object, EventArgs)	Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control)
OnClick(ImageClickEventArgs)	Löst das Click Ereignis aus und ermöglicht es Ihnen, das Click Ereignis direkt zu behandeln.
OnCommand(CommandEventArgs)	Löst das Command Ereignis aus und ermöglicht es Ihnen, das Command Ereignis direkt zu behandeln.
OnDataBinding(EventArgs)	Löst das DataBinding-Ereignis aus. (Geerbt von Control)
OnInit(EventArgs)	Löst das Init-Ereignis aus. (Geerbt von Control)
OnLoad(EventArgs)	Löst das Load-Ereignis aus. (Geerbt von Control)
OnPreRender(EventArgs)	Bestimmt, ob das Bild vor dem Rendern auf den Client geklickt wurde.
OnUnload(EventArgs)	Löst das Unload-Ereignis aus. (Geerbt von Control)
OpenFile(String)	Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)	Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control)
RaisePostBackEvent(String)	Löst Ereignisse für das ImageButton Steuerelement aus, wenn es wieder auf dem Server veröffentlicht wird.
RaisePostDataChangedEvent()	Benachrichtigt die ASP.NET Anwendung, dass sich der Status des ImageButton Steuerelements geändert hat.
RemovedControl(Control)	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control)
Render(HtmlTextWriter)	Rendert das Steuerelement an den angegebenen HTML-Writer. (Geerbt von WebControl)
RenderBeginTag(HtmlTextWriter)	Rendert das HTML-Öffnungstag des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
RenderChildren(HtmlTextWriter)	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control)
RenderContents(HtmlTextWriter)	Rendert den Inhalt des Bildsteuerelements an den angegebenen Writer. (Geerbt von Image)
RenderControl(HtmlTextWriter, ControlAdapter)	Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriter ControlAdapter Objekt aus. (Geerbt von Control)
RenderControl(HtmlTextWriter)	Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control)
RenderEndTag(HtmlTextWriter)	Rendert das HTML-Schließen-Tag des Steuerelements in den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
ResolveAdapter()	Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control)
ResolveClientUrl(String)	Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control)
ResolveUrl(String)	Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control)
SaveControlState()	Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control)
SaveViewState()	Speichert jeden Zustand, der geändert wurde, nachdem die TrackViewState() Methode aufgerufen wurde. (Geerbt von WebControl)
SetDesignModeState(IDictionary)	Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)	Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control)
SetTraceData(Object, Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
SetTraceData(Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt, dass das Steuerelement Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des ViewState Objekts gespeichert werden können. (Geerbt von WebControl)

Ereignisse

Name	Beschreibung
Click	Tritt auf, wenn auf die ImageButton Schaltfläche geklickt wird.
Command	Tritt auf, wenn auf die ImageButton Schaltfläche geklickt wird.
DataBinding	Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control)
Disposed	Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control)
Init	Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control)
Load	Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control)
PreRender	Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control)
Unload	Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IAttributeAccessor.GetAttribute(String)	Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl)
IAttributeAccessor.SetAttribute(String, String)	Legt ein Attribut des Websteuerelements auf den angegebenen Namen und Wert fest. (Geerbt von WebControl)
IButtonControl.Click	Eine Beschreibung dieses Mitglieds finden Sie im Click Ereignis.
IButtonControl.Text	Eine Beschreibung dieses Mitglieds finden Sie unter Text.
IControlBuilderAccessor.ControlBuilder	Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()	Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control)
IControlDesignerAccessor.UserData	Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control)
IDataBindingsAccessor.DataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control)
IDataBindingsAccessor.HasDataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control)
IExpressionsAccessor.Expressions	Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control)
IExpressionsAccessor.HasExpressions	Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)	Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Eine Beschreibung dieses Mitglieds finden Sie unter LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Eine Beschreibung dieses Mitglieds finden Sie unter RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Eine Beschreibung dieses Mitglieds finden Sie unter RaisePostBackEvent(String).

Erweiterungsmethoden

Name	Beschreibung
FindDataSourceControl(Control)	Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.
FindFieldTemplate(Control, String)	Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.
FindMetaTable(Control)	Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?