ImageMap Klasse

Definition

Erstellt ein Steuerelement, das ein Bild auf einer Seite anzeigt.Creates a control that displays an image on a page. Wenn auf einen innerhalb des ImageMap-Steuerelements definierten Hotspotbereich geklickt wird, generiert das Steuerelement entweder einen Postback auf den Server oder navigiert zu einer angegebenen URL.When a hot spot region defined within the ImageMap control is clicked, the control either generates a postback to the server or navigates to a specified URL.

public ref class ImageMap : System::Web::UI::WebControls::Image, System::Web::UI::IPostBackEventHandler
public class ImageMap : System.Web.UI.WebControls.Image, System.Web.UI.IPostBackEventHandler
type ImageMap = class
    inherit Image
    interface IPostBackEventHandler
Public Class ImageMap
Inherits Image
Implements IPostBackEventHandler
Vererbung
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ImageMap -Steuerelement, das zwei CircleHotSpot -Objekte enthält, deklarativ erstellt wird.The following code example demonstrates how to declaratively create an ImageMap control that contains two CircleHotSpot objects. Die HotSpot.HotSpotMode -Eigenschaft ist auf HotSpotMode.Navigatefestgelegt, sodass die Seite jedes Mal, wenn ein Benutzer auf eine der Kreis-Hot-Spot-Bereiche klickt, zur angegebenen URL navigiert.The HotSpot.HotSpotMode property is set to HotSpotMode.Navigate, which causes the page to navigate to the specified URL each time a user clicks one of the circle hot spot regions. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie für die ImageUrl -Eigenschaft ein eigenes Image bereitstellen und den Pfad zum Bild entsprechend aktualisieren, damit die Anwendung es finden kann.For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.

<%@ page language="C#" %>

<!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 id="head1" runat="server">
  <title>ImageMap Class Navigate Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Navigate Example</h3>
      
      <h4>Shopping Choices:</h4>
      
      <asp:imagemap id="Shop"           
        imageurl="Images/ShopChoice.jpg"
        width="150" 
        height="360"
        alternatetext="Shopping choices" 
        runat="Server">    
        
        <asp:circlehotspot
          navigateurl="http://www.tailspintoys.com"
          x="75"
          y="290"
          radius="75"
          hotspotmode="Navigate"
          alternatetext="Shop for toys">           
        </asp:circlehotspot> 
        
        <asp:circlehotspot
          navigateurl="http://www.cohowinery.com"
          x="75"
          y="120"
          radius="75"
          hotspotmode="Navigate"
          alternatetext="Shop for wine">
        </asp:circlehotspot>     
          
      </asp:imagemap>                 
                 
    </form>      
  </body>
</html>
<%@ Page Language="VB" %>

<!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 id="head1" runat="server">
  <title>ImageMap Class Navigate Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Navigate Example</h3>
      
      <h4>Shopping Choices:</h4>
      
       <asp:imagemap id="Shop"           
        imageurl="Images/ShopChoice.jpg"
        alternatetext="Shopping choices" 
        runat="Server">    
        
        <asp:circlehotspot
          navigateurl="http://www.tailspintoys.com"
          x="145"
          y="120"
          radius="75"
          hotspotmode="Navigate"
          alternatetext="Shop for toys">           
        </asp:circlehotspot> 
        
        <asp:circlehotspot
          navigateurl="http://www.cohowinery.com"
          x="145"
          y="290"
          radius="75"
          hotspotmode="Navigate"
          alternatetext="Shop for wine">
        </asp:circlehotspot>     
          
      </asp:imagemap>                 
                 
    </form>      
  </body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie ein ImageMap -Steuerelement, das zwei RectangleHotSpot -Objekte enthält, deklarativ erstellt wird.The following code example demonstrates how to declaratively create an ImageMap control that contains two RectangleHotSpot objects. Die ImageMap.HotSpotMode -Eigenschaft ist auf HotSpotMode.PostBackfestgelegt, sodass die Seite jedes Mal, wenn ein Benutzer auf eine der Hotspot Bereiche klickt, an den Server zurückgesendet wird.The ImageMap.HotSpotMode property is set to HotSpotMode.PostBack, which causes the page to post back to the server each time a user clicks one of the hot spot regions. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie für die ImageUrl -Eigenschaft ein eigenes Image bereitstellen und den Pfad zum Bild entsprechend aktualisieren, damit die Anwendung es finden kann.For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.

<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  void VoteMap_Clicked (Object sender, ImageMapEventArgs e)
  {
    string coordinates;
    string hotSpotType;
    int yescount = ((ViewState["yescount"] != null)? (int)ViewState["yescount"] : 0);
    int nocount = ((ViewState["nocount"] != null)? (int)ViewState["nocount"] : 0);

    // When a user clicks the "Yes" hot spot,
    // display the hot spot's name and coordinates.
    if (e.PostBackValue.Contains("Yes"))
    {
      yescount += 1;
      coordinates = Vote.HotSpots[0].GetCoordinates();
      hotSpotType = Vote.HotSpots[0].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
                      "The current vote count is " + yescount.ToString() + 
            " yes votes and " + nocount.ToString() + " no votes.";
    }
      
    // When a user clicks the "No" hot spot,
    // display the hot spot's name and coordinates.
    else if (e.PostBackValue.Contains("No"))
    {
      nocount += 1;
      coordinates = Vote.HotSpots[1].GetCoordinates();
      hotSpotType = Vote.HotSpots[1].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
            "The current vote count is " + yescount.ToString() +
            " yes votes and " + nocount.ToString() + " no votes.";
    }
    
    else
    {
      Message1.Text = "You did not click a valid hot spot region.";
    }

    ViewState["yescount"] = yescount;
    ViewState["nocount"] = nocount;
  }           
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  Sub VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    Dim coordinates As String
    Dim hotSpotType As String
    Dim yescount As Integer
    Dim nocount As Integer
    
    If (ViewState("yescount") IsNot Nothing) Then
      yescount = Convert.ToInt32(ViewState("yescount"))
    Else
      yescount = 0
    End If
    If (ViewState("nocount") IsNot Nothing) Then
      nocount = Convert.ToInt32(ViewState("nocount"))
    Else
      nocount = 0
    End If
      
    
    ' When a user clicks the "Yes" hot spot,
    ' display the hot spot's name and coordinates.
    If (e.PostBackValue.Contains("Yes")) Then
      
      yescount += 1
      coordinates = Vote.HotSpots(0).GetCoordinates()
      hotSpotType = Vote.HotSpots(0).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                      "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
       
      ' When a user clicks the "No" hot spot,
      ' display the hot spot's name and coordinates.
    ElseIf (e.PostBackValue.Contains("No")) Then
      
      nocount += 1
      coordinates = Vote.HotSpots.Item(1).GetCoordinates()
      hotSpotType = Vote.HotSpots.Item(1).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                     "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
      
    Else
      
      Message1.Text = "You did not click a valid hot spot region."
                
    End If
      
    ViewState("yescount") = yescount
    ViewState("nocount") = nocount
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie ein ImageMap -Steuerelement erstellt wird, das Hotspots mit unterschiedlichen Verhalten enthält.The following code example demonstrates how to create an ImageMap control that contains hot spots with different behaviors. Der Hintergrundbereich ist ein, der als einzelner RectangleHotSpot definiert ist, der an den Server zurücksendet.The background area is a defined as a single RectangleHotSpot that posts back to the server. Drei RectangleHotSpot Objekte werden in derselben Region definiert.Three RectangleHotSpot objects are defined in the same region. Jeder dieser Hotspots sieht wie eine Schaltfläche aus und navigiert zu einer URL.Each of these hot spots looks like a button and navigates to a URL. Wenn in ImageMap einer Region, in der sich zwei Hotspots überlappen, auf ein-Steuerelement geklickt wird, hat der Hotspot, der zuerst deklariert wird, Vorrang.When an ImageMap control is clicked in a region where two hot spots overlap, the hot spot that is declared first has precedence. In diesem Beispiel werden die Schaltflächen Hot-Spots zuerst deklariert, und der Background-Hotspot, der Sie enthält, wird als letztes deklariert.In this example, the button hot spots are declared first and the background hot spot that contains them is declared last. Daher erhält der Benutzer das Verhalten des Schalt RectangleHotSpot Flächen Objekts, nicht des Background RectangleHotSpot -Objekts, wenn der Benutzer auf eine Schaltfläche für den Hotspot klickt.Therefore, the user gets the behavior of the button RectangleHotSpot object, not the background RectangleHotSpot object, when the user clicks a button hot spot. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie für die ImageUrl -Eigenschaft ein eigenes Image bereitstellen und den Pfad zum Bild entsprechend aktualisieren, damit die Anwendung es finden kann.For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.

<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  void ButtonsMap_Clicked(object sender, ImageMapEventArgs e)
  {       
    // When a user clicks the "Background" hot spot,
    // display the hot spot's value.
    if (e.PostBackValue == "Background")
    {
      string coordinates = Buttons.HotSpots[3].GetCoordinates();
      Message1.Text = "You selected the " + e.PostBackValue + "<br />" +
                                "The coordinates are " + coordinates;
    }
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Mixed HotSpotMode Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Mixed HotSpotMode Example</h3>
      
      <!--In this scenario, the ImageMap.HotSpotMode
      property is not set, because the 
      HotSpotMode property is set on each individual
      RectangleHotSpot object to specify its behavior.-->
      <asp:imagemap id="Buttons"           
        imageurl="Images/MixedImage.jpg"
        width="350"
        height="350" 
        alternatetext="Navigation buttons"
        hotspotmode="NotSet"     
        onclick="ButtonsMap_Clicked"
        runat="Server">                 
        
        <asp:RectangleHotSpot
          hotspotmode="Navigate"
          NavigateUrl="http://www.contoso.com"
          alternatetext="Button 1"
          top="50"
          left="50"
          bottom="100"
          right="300">
        </asp:RectangleHotSpot>
        
        <asp:RectangleHotSpot  
          hotspotmode="Navigate"
          NavigateUrl="http://www.tailspintoys.com"
          alternatetext="Button 2"        
          top="150"
          left="50"
          bottom="200"
          right="300">          
        </asp:RectangleHotSpot>
        
        <asp:RectangleHotSpot
          hotspotmode="Navigate"
          NavigateUrl="http://www.cohowinery.com"
          alternatetext="Button 3"          
          top="250"
          left="50"
          bottom="300"
          right="300">
        </asp:RectangleHotSpot> 
        
        <asp:RectangleHotSpot 
          hotspotmode="PostBack"
          PostBackValue="Background"
          alternatetext="Background"
          top="0"
          left="0"
          bottom="350"
          right="350">
        </asp:RectangleHotSpot>      
      
      </asp:imagemap>
            
      <br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>
<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  Sub ButtonsMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    ' When a user clicks the "Background" hot spot,
    ' display the hot spot's value.
    If (e.PostBackValue = "Background") Then
      
      Dim coordinates As String
      coordinates = Buttons.HotSpots(3).GetCoordinates()
      Message1.Text = "You selected the " & e.PostBackValue & "<br />" & _
                      "The coordinates are " & coordinates
      
    End If
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Mixed HotSpotMode Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Mixed HotSpotMode Example</h3>
      
      <!--In this scenario, the ImageMap.HotSpotMode
      property is not set, because the 
      HotSpotMode property is set on each individual
      RectangleHotSpot object to specify its behavior.-->
      <asp:imagemap id="Buttons"           
        imageurl="Images/MixedImage.jpg"
        width="350"
        height="350" 
        alternatetext="Navigation buttons"
        hotspotmode="NotSet"     
        onclick="ButtonsMap_Clicked"
        runat="Server">                 
        
        <asp:RectangleHotSpot
          hotspotmode="Navigate"
          NavigateUrl="http://www.contoso.com"
          alternatetext="Button 1"
          top="50"
          left="50"
          bottom="100"
          right="300">
        </asp:RectangleHotSpot>
        
        <asp:RectangleHotSpot  
          hotspotmode="Navigate"
          NavigateUrl="http://www.tailspintoys.com"
          alternatetext="Button 2"        
          top="150"
          left="50"
          bottom="200"
          right="300">          
        </asp:RectangleHotSpot>
        
        <asp:RectangleHotSpot
          hotspotmode="Navigate"
          NavigateUrl="http://www.cohowinery.com"
          alternatetext="Button 3"          
          top="250"
          left="50"
          bottom="300"
          right="300">
        </asp:RectangleHotSpot> 
        
        <asp:RectangleHotSpot 
          hotspotmode="PostBack"
          PostBackValue="Background"
          alternatetext="Background"
          top="0"
          left="0"
          bottom="350"
          right="350">
        </asp:RectangleHotSpot>       
      
      </asp:imagemap>
            
      <br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Hinweise

In diesem Thema:In this topic:

EinführungIntroduction

Verwenden Sie ImageMap das-Steuerelement, um ein Image zu erstellen, das definierte Hotspot Bereiche enthält.Use the ImageMap control to create an image that contains defined hot spot regions. Wenn ein Benutzer auf einen Hotspot Bereich klickt, kann das Steuerelement entweder ein Postback an den Server generieren oder zu einer angegebenen URL navigieren.When a user clicks a hot spot region, the control can either generate a postback to the server or navigate to a specified URL. Beispielsweise können Sie mit diesem Steuerelement eine Karte einer geografischen Region anzeigen.For example, you can use this control to display a map of a geographical region. Wenn ein Benutzer auf eine bestimmte Region auf der Karte klickt, navigiert das Steuerelement zu einer URL, die zusätzliche Daten über den ausgewählten Bereich bereitstellt.When a user clicks a specific region on the map, the control navigates to a URL that provides additional data about the selected region. Mit diesem Steuerelement können Sie auch ein Postback an den Server generieren und bestimmten Code basierend auf dem Hotspot Bereich ausführen, auf den geklickt wurde.You can also use this control to generate a postback to the server and run specific code based on the hot spot region that was clicked. Beispielsweise können Sie ein ImageMap -Steuerelement verwenden, um Benutzer Antworten, z. b. Stimmen, zu erfassen.For example, you can use an ImageMap control to capture user responses such as votes. Wenn ein Benutzer auf den Hotspot Bereich klickt, der für Yes-Stimmen definiert ist, wird Code aufgerufen, um eine ja-Antwort in einer Datenbank aufzuzeichnen.When a user clicks the hot spot region defined for yes votes, code is called to record a yes response in a database. Wenn ein Benutzer auf den Hot-Spot-Bereich klickt, der für keine Stimmen definiert ist, wird keine Antwort aufgezeichnet.When a user clicks on the hot spot region defined for no votes, a no response is recorded. Sie können diese beiden Szenarien auch innerhalb eines einzigen ImageMap Steuer Elements kombinieren.You can also mix these two scenarios within a single ImageMap control. Beispielsweise können Sie einen Hotspot Bereich angeben, um zu einer URL zu navigieren, und einen anderen Hotspot Bereich, um Sie an den Server zurückzusenden.For example, you can specify one hot spot region to navigate to a URL and another hot spot region to post back to the server.

Verwenden Sie ImageUrl die-Eigenschaft, um den Pfad zu dem Bild anzugeben, ImageMap das für das Steuerelement angezeigt werden soll.Use the ImageUrl property to specify the path to the image to display for the ImageMap control. Sie können eine beliebige Anzahl von HotSpot Objekten innerhalb eines ImageMap -Steuer Elements definieren.You can define any number of HotSpot objects within an ImageMap control. Sie können die CircleHotSpotKlassen, RectangleHotSpotund PolygonHotSpot verwenden, um Hotspot Bereiche zu definieren.You can use the CircleHotSpot, RectangleHotSpot, and PolygonHotSpot classes to define hot spot regions. Alternativ können Sie von der abstrakten HotSpot -Klasse ableiten, um Ihr eigenes benutzerdefiniertes Hot-Spot-Objekt zu definieren.Alternatively, you can derive from the abstract HotSpot class to define your own custom hot spot object.

Es gibt zwei Möglichkeiten, das Verhalten eines HotSpot -Objekts in einem ImageMap -Steuerelement anzugeben HotSpot , wenn auf das geklickt wird.There are two ways to specify the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked. Sie können entweder HotSpotMode die-Eigenschaft für das ImageMap -Steuerelement oder die HotSpotMode -Eigenschaft HotSpot für ein einzelnes-Objekt verwenden.You can use either the HotSpotMode property on the ImageMap control or the HotSpotMode property on an individual HotSpot object. Diese Eigenschaften werden mit einem der HotSpotMode -Enumerationswerte festgelegt.These properties are set using one of the HotSpotMode enumeration values. Wenn beide Eigenschaften festgelegt sind, HotSpotMode hat die für jedes einzelne HotSpot Objekt angegebene Eigenschaft Vorrang vor HotSpotMode ImageMap der Eigenschaft des Steuer Elements.If both properties are set, the HotSpotMode property specified on each individual HotSpot object takes precedence over the HotSpotMode property on the ImageMap control.

Um zu einer URL zu navigieren, legen Sie ImageMap.HotSpotMode entweder die- HotSpot.HotSpotMode Eigenschaft oder HotSpotMode.Navigatedie-Eigenschaft auf fest.To navigate to a URL, set either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property to HotSpotMode.Navigate. Verwenden Sie NavigateUrl die-Eigenschaft, um die URL für die Navigation anzugeben.Use the NavigateUrl property to specify the URL to navigate to.

Um ein Postback an den Server zu generieren, legen Sie ImageMap.HotSpotMode entweder die- HotSpot.HotSpotMode Eigenschaft oder HotSpotMode.Postbackdie-Eigenschaft auf fest.To generate a postback to the server, set either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property to HotSpotMode.Postback. Verwenden Sie PostBackValue die-Eigenschaft, um einen Namen für den Hotspot Bereich anzugeben.Use the PostBackValue property to specify a name for the hot spot region. Dieser Name wird in den ImageMapEventArgs Ereignisdaten beim Auftreten eines Post Back Ereignisses ausgegeben.This name will be passed in the ImageMapEventArgs event data when a postback event occurs. Wenn auf ein Postback HotSpot geklickt wird, wird das Click -Ereignis ausgelöst.When a postback HotSpot is clicked, the Click event is raised. Um die Aktionen Programm gesteuert zu steuern, die beim Klicken HotSpot auf ein Postback ausgeführt werden, geben Sie Click einen Ereignishandler für das Ereignis an.To programmatically control the actions performed when a postback HotSpot is clicked, provide an event handler for the Click event.

Wenn alle HotSpot -Objekte in einem ImageMap -Steuerelement das gleiche Verhalten aufweisen sollen, ImageMap.HotSpotMode verwenden Sie die-Eigenschaft, um das Verhalten festzulegen.To cause all HotSpot objects in an ImageMap control to have the same behavior, use the ImageMap.HotSpotMode property to specify the behavior. Legen Sie dann entweder die HotSpot.HotSpotMode -Eigenschaft für jedes HotSpot einzelne- HotSpotMode.NotSet Objekt auf fest, oder geben Sie keinen HotSpot.HotSpotMode Wert für die-Eigenschaft an.Then, either set the HotSpot.HotSpotMode property on each individual HotSpot object to HotSpotMode.NotSet or do not specify a value for the HotSpot.HotSpotMode property.

Um unterschiedliche Verhalten für HotSpot Objekte in einem ImageMapanzugeben, legen HotSpot.HotSpotMode Sie die-Eigenschaft HotSpot für jedes einzelne HotSpotMode.Navigate - HotSpotMode.PostBackObjekt entweder auf oder fest.To specify different behaviors for HotSpot objects in an ImageMap, set the HotSpot.HotSpotMode property on each individual HotSpot object to either HotSpotMode.Navigate or HotSpotMode.PostBack.

Hinweis

Wenn die ImageMap -Eigenschaft ImageMap.HotSpotMode eines Steuer Elements HotSpot.HotSpotMode oder die-Eigenschaft für HotSpot eines der enthaltenen-Objekte auf HotSpotMode.NotSet festgelegt ist oder nicht auf einen Wert festgelegt ist, ist HotSpotMode.Navigatedas Verhalten standardmäßig.If an ImageMap control's ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property on any of the HotSpot objects it contains is set to HotSpotMode.NotSet or is not set to a value, by default the behavior is HotSpotMode.Navigate.

ZugriffAccessibility

Weitere Informationen zur Verwendung dieses Steuerelement so konfigurieren, dass sie Markup generiert, das Accessibility Standards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und ASP.NET-Steuerelemente und Barrierefreiheit.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Deklarative SyntaxDeclarative Syntax

<asp:ImageMap  
    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"  
    CssClass="string"  
    DescriptionUrl="uri"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ForeColor="color name|#dddddd"  
    Height="size"  
    HotSpotMode="NotSet|Navigate|PostBack|Inactive"  
    ID="string"  
    ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|  
        AbsBottom|AbsMiddle|TextTop"  
    ImageUrl="uri"  
    OnClick="Click 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"  
    runat="server"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    Target="string"  
    ToolTip="string"  
    Visible="True|False"  
    Width="size"  
>  
            <asp:CircleHotSpot  
                AccessKey="string"  
                AlternateText="string"  
                HotSpotMode="NotSet|Navigate|PostBack|Inactive"  
                NavigateUrl="uri"  
                PostBackValue="string"  
                Radius="integer"  
                TabIndex="integer"  
                Target="string|_blank|_parent|_search|_self|_top"  
                X="integer"  
                Y="integer"  
            />  
            <asp:PolygonHotSpot  
                AccessKey="string"  
                AlternateText="string"  
                Coordinates="string"  
                HotSpotMode="NotSet|Navigate|PostBack|Inactive"  
                NavigateUrl="uri"  
                PostBackValue="string"  
                TabIndex="integer"  
                Target="string|_blank|_parent|_search|_self|_top"  
            />  
            <asp:RectangleHotSpot  
                AccessKey="string"  
                AlternateText="string"  
                Bottom="integer"  
                HotSpotMode="NotSet|Navigate|PostBack|Inactive"  
                Left="integer"  
                NavigateUrl="uri"  
                PostBackValue="string"  
                Right="integer"  
                TabIndex="integer"  
                Target="string|_blank|_parent|_search|_self|_top"  
                Top="integer"  
            />  
</asp:ImageMap>  

Konstruktoren

ImageMap()

Initialisiert eine neue Instanz der ImageMap-Klasse.Initializes a new instance of the ImageMap class.

Eigenschaften

AccessKey

Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Geerbt von WebControl)
Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.Gets the browser-specific adapter for the control.

(Geerbt von Control)
AlternateText

Ruft den Alternativtext ab, der im Image-Steuerelement angezeigt wird, wenn das Bild nicht verfügbar ist, oder legt diesen fest.Gets or sets the alternate text displayed in the Image control when the image is unavailable. In Browsern, die das QuickInfo-Feature unterstützen, wird dieser Text als QuickInfo angezeigt.Browsers that support the ToolTips feature display this text as a ToolTip.

(Geerbt von Image)
AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Geerbt von Control)
Attributes

Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Geerbt von WebControl)
BackColor

Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest.Gets or sets the background color of the Web server control.

(Geerbt von WebControl)
BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.Gets the control that contains this control's data binding.

(Geerbt von Control)
BorderColor

Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest.Gets or sets the border color of the Web control.

(Geerbt von WebControl)
BorderStyle

Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest.Gets or sets the border style of the Web server control.

(Geerbt von WebControl)
BorderWidth

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.Gets or sets the border width of the Web server control.

(Geerbt von WebControl)
ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.Gets a value that indicates whether the server control's child controls have been created.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.Gets the control ID for HTML markup that is generated by ASP.NET.

(Geerbt von Control)
ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.Gets a character value representing the separator character used in the ClientID property.

(Geerbt von Control)
Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.Gets the HttpContext object associated with the server control for the current Web request.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Geerbt von Control)
ControlStyle

Ruft den Stil des Webserversteuerelements ab.Gets the style of the Web server control. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Geerbt von WebControl)
ControlStyleCreated

Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde.Gets a value indicating whether a Style object has been created for the ControlStyle property. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is primarily used by control developers.

(Geerbt von WebControl)
CssClass

Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Geerbt von WebControl)
DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Geerbt von Control)
DescriptionUrl

Ruft den Speicherort für eine ausführliche Beschreibung des Bilds ab oder legt diesen fest.Gets or sets the location to a detailed description for the image.

(Geerbt von Image)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.Gets a value indicating whether a control is being used on a design surface.

(Geerbt von Control)
Enabled

Ruft einen Wert ab, der angibt, ob das Steuerelement auf Benutzerinteraktionen reagieren kann, oder legt diesen fest.Gets or sets a value indicating whether the control can respond to user interaction.

EnableTheming

Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest.Gets or sets a value indicating whether themes apply to this control.

(Geerbt von WebControl)
EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab.Gets a list of event handler delegates for the control. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

(Geerbt von Control)
Font

Ruft für den Text, der dem Steuerelement zugeordnet ist, die Eigenschaften für die Schriftart ab.Gets the font properties for the text associated with the control.

(Geerbt von Image)
ForeColor

Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Geerbt von WebControl)
GenerateEmptyAlternateText

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement für einen leeren Zeichenfolgenwert ein Alternativtextattribut generiert.Gets or sets a value indicating whether the control generates an alternate text attribute for an empty string value.

(Geerbt von Image)
HasAttributes

Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden.Gets a value indicating whether the control has attributes set.

(Geerbt von WebControl)
HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Geerbt von Control)
Height

Ruft die Höhe des Webserversteuerelements ab oder legt diese fest.Gets or sets the height of the Web server control.

(Geerbt von WebControl)
HotSpotMode

Ruft das Standardverhalten der HotSpot-Objekte eines ImageMap-Steuerelements ab, wenn auf die betreffenden HotSpot-Objekte geklickt wird, oder legt dieses fest.Gets or sets the default behavior for the HotSpot objects of an ImageMap control when the HotSpot objects are clicked.

HotSpots

Ruft eine Auflistung von HotSpot-Objekten ab, die die in einem ImageMap-Steuerelement definierten Hotspotbereiche darstellt.Gets a collection of HotSpot objects that represents the defined hot spot regions in an ImageMap control.

ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.Gets or sets the programmatic identifier assigned to the server control.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.Gets the character used to separate control identifiers.

(Geerbt von Control)
ImageAlign

Ruft die Ausrichtung des Image-Steuerelements im Verhältnis zu anderen Elementen auf der Webseite ab oder legt diese fest.Gets or sets the alignment of the Image control in relation to other elements on the Web page.

(Geerbt von Image)
ImageUrl

Ruft die URL ab, die den Pfad zu einem Image bereitstellt, das im Image-Steuerelement angezeigt werden soll, oder legt sie fest.Gets or sets the URL that provides the path to an image to display in the Image control.

(Geerbt von Image)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.Gets a value indicating whether controls contained within this control have control state.

(Geerbt von Control)
IsEnabled

Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist.Gets a value indicating whether the control is enabled.

(Geerbt von WebControl)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.Gets a value that indicates whether the server control is saving changes to its view state.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.Gets a value indicating whether view state is enabled for this control.

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Geerbt von Control)
NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Geerbt von Control)
Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.Gets a reference to the Page instance that contains the server control.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.Gets a reference to the server control's parent control in the page control hierarchy.

(Geerbt von Control)
RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Geerbt von Control)
Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.Gets information about the container that hosts the current control when rendered on a design surface.

(Geerbt von Control)
SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.Gets or sets the skin to apply to the control.

(Geerbt von WebControl)
Style

Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Geerbt von WebControl)
SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Geerbt von Image)
TabIndex

Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.Gets or sets the tab index of the Web server control.

(Geerbt von WebControl)
TagKey

Ruft den HtmlTextWriterTag-Wert ab, der diesem Webserversteuerelement entspricht.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Geerbt von WebControl)
TagName

Ruft den Namen des Steuerelementtags ab.Gets the name of the control tag. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Geerbt von WebControl)
Target

Ruft das Zielfenster oder den Zielframe ab bzw. legt es oder ihn fest, in dem der Inhalt der verknüpften Webseite angezeigt werden soll, wenn auf das ImageMap-Steuerelement geklickt wird.Gets or sets the target window or frame that displays the Web page content linked to when the ImageMap control is clicked.

TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.Gets or sets a reference to the template that contains this control.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Geerbt von Control)
ToolTip

Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Geerbt von WebControl)
UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.Gets the unique, hierarchically qualified identifier for the server control.

(Geerbt von Control)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.Gets a value that indicates whether the StateBag object is case-insensitive.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.Gets or sets the view-state mode of this control.

(Geerbt von Control)
Visible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Geerbt von Control)
Width

Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest.Gets or sets the width of the Web server control.

(Geerbt von WebControl)

Methoden

AddAttributesToRender(HtmlTextWriter)

Fügt die HTML-Attribute und -Stile eines ImageMap-Steuerelements hinzu, die in dem angegebenen HtmlTextWriter gerendert werden sollen.Adds the HTML attributes and styles of an ImageMap control to be rendered to the specified HtmlTextWriter.

AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.Called after a child control is added to the Controls collection of the Control object.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Geerbt von Control)
ApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is primarily used by control developers.

(Geerbt von WebControl)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.Applies the style properties defined in the page style sheet to the control.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.Begins design-time tracing of rendering data.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.Sets the cached ClientID value to null.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.Deletes the control-state information for the server control's child controls.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state and control-state information for all the server control's child controls.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state information for all the server control's child controls.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Geerbt von Control)
CopyBaseAttributes(WebControl)

Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
CreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Geerbt von Control)
CreateControlStyle()

Erstellt das Formatvorlagenobjekt, das von der WebControl-Klasse intern zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften verwendet wird.Creates the style object that is used internally by the WebControl class to implement all style related properties. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.Binds a data source to the invoked server control and all its child controls.

(Geerbt von Control)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.Binds a data source to the server control's child controls.

(Geerbt von Control)
Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.Enables a server control to perform final clean up before it is released from memory.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.Ends design-time tracing of rendering data.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines whether the server control contains child controls. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.If it does not, it creates child controls.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.Creates an identifier for controls that do not have an identifier assigned.

(Geerbt von Control)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.Searches the current naming container for a server control with the specified id parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Sie sollten diese Version der FindControl-Methode nicht überschreiben.You should not override this version of the FindControl method.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.Sets input focus to a control.

(Geerbt von Control)
GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.Gets design-time data for a control.

(Geerbt von Control)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.Returns the prefixed portion of the UniqueID property of the specified control.

(Geerbt von Control)
HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines if the server control contains any child controls.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.Returns a value indicating whether events are registered for the control or any child controls.

(Geerbt von Control)
IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.Determines if the server control holds only literal content.

(Geerbt von Control)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Geerbt von Control)
LoadViewState(Object)

Stellt die Ansichtszustandsinformationen für das ImageMap-Steuerelement aus einer früheren Seitenanforderung wieder her, die mithilfe der SaveViewState()-Methode gespeichert wurden.Restores view-state information for the ImageMap control from a previous page request that was saved by the SaveViewState() method.

MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MergeStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Geerbt von Control)
OnClick(ImageMapEventArgs)

Löst das Click-Ereignis für das ImageMap-Steuerelement aus.Raises the Click event for the ImageMap control.

OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.Raises the DataBinding event.

(Geerbt von Control)
OnInit(EventArgs)

Löst das Init-Ereignis aus.Raises the Init event.

(Geerbt von Control)
OnLoad(EventArgs)

Löst das Load-Ereignis aus.Raises the Load event.

(Geerbt von Control)
OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.Raises the PreRender event.

(Geerbt von Control)
OnUnload(EventArgs)

Löst das Unload-Ereignis aus.Raises the Unload event.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.Gets a Stream used to read a file.

(Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.Assigns any sources of the event and its information to the control's parent.

(Geerbt von Control)
RaisePostBackEvent(String)

Löst Ereignisse für das ImageMap-Steuerelement aus, wenn ein Formular an den Server zurückgesendet wird.Raises events for the ImageMap control when a form is posted back to the server.

RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.Called after a child control is removed from the Controls collection of the Control object.

(Geerbt von Control)
Render(HtmlTextWriter)

Sendet den Inhalt des ImageMap-Steuerelements an das angegebene HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt.Sends the ImageMap control content to the specified HtmlTextWriter object, which writes the content to render on the client.

RenderBeginTag(HtmlTextWriter)

Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder.Renders the HTML opening tag of the control to the specified writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Geerbt von Control)
RenderContents(HtmlTextWriter)

Rendert den Inhalt der Bildsteuerung in den angegebenen Writer.Renders the image control contents to the specified writer.

(Geerbt von Image)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Geerbt von Control)
RenderEndTag(HtmlTextWriter)

Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar.Renders the HTML closing tag of the control into the specified writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.Gets the control adapter responsible for rendering the specified control.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.Gets a URL that can be used by the browser.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.Converts a URL into one that is usable on the requesting client.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Geerbt von Control)
SaveViewState()

Speichert alle Änderungen am Ansichtszustand eines ImageMap-Steuerelements, die seit dem letzten Zurücksenden der Seite an den Server aufgetreten sind.Saves any changes to an ImageMap control's view-state that have occurred since the time the page was posted back to the server.

SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.Sets design-time data for a control.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.Assigns an event handler delegate to render the server control and its content into its parent control.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TrackViewState()

Verfolgt die am Ansichtszustand des ImageMap-Steuerelements vorgenommenen Änderungen und speichert diese im StateBag-Objekt des Steuerelements.Tracks view-state changes to the ImageMap control so they can be stored in the control's StateBag object. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden.This object is accessible through the ViewState property.

Ereignisse

Click

Tritt ein, wenn in einem HotSpot-Steuerelement auf ein ImageMap-Objekt geklickt wird.Occurs when a HotSpot object in an ImageMap control is clicked.

DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.Occurs when the server control binds to a data source.

(Geerbt von Control)
Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Geerbt von Control)
Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Geerbt von Control)
Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.Occurs when the server control is loaded into the Page object.

(Geerbt von Control)
PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.Occurs after the Control object is loaded but prior to rendering.

(Geerbt von Control)
Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.Occurs when the server control is unloaded from memory.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String)

Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.Gets an attribute of the Web control with the specified name.

(Geerbt von WebControl)
IAttributeAccessor.SetAttribute(String, String)

Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest.Sets an attribute of the Web control to the specified name and value.

(Geerbt von WebControl)
IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.For a description of this member, see ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().For a description of this member, see GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.For a description of this member, see UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.For a description of this member, see DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.For a description of this member, see HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.For a description of this member, see Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.For a description of this member, see HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Geerbt von Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Eine Beschreibung dieses Elements finden Sie unter RaisePostBackEvent(String).For a description of this member, see RaisePostBackEvent(String).

Erweiterungsmethoden

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.Returns the metatable object for the containing data control.

Gilt für:

Siehe auch