ImageMap Classe

Définition

Crée un contrôle qui affiche une image sur une page. Quand un utilisateur clique sur une zone réactive définie dans le contrôle ImageMap, le contrôle génère une publication (postback) sur le serveur ou atteint une URL spécifiée.

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
Héritage
Implémente

Exemples

L’exemple de code suivant montre comment créer de manière déclarative un ImageMap contrôle qui contient deux CircleHotSpot objets. La HotSpot.HotSpotMode propriété a la HotSpotMode.Navigatevaleur , ce qui permet à la page d’accéder à l’URL spécifiée chaque fois qu’un utilisateur clique sur l’une des régions de point chaud du cercle. Pour que cet exemple fonctionne correctement, vous devez fournir votre propre image pour la ImageUrl propriété et mettre à jour le chemin d’accès à l’image de manière appropriée afin que l’application puisse la localiser.

<%@ 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>

L’exemple de code suivant montre comment créer de manière déclarative un ImageMap contrôle qui contient deux RectangleHotSpot objets. La ImageMap.HotSpotMode propriété est définie sur HotSpotMode.PostBack, ce qui entraîne la publication de la page sur le serveur chaque fois qu’un utilisateur clique sur l’une des régions de point chaud. Pour que cet exemple fonctionne correctement, vous devez fournir votre propre image pour la ImageUrl propriété et mettre à jour le chemin d’accès à l’image de manière appropriée afin que l’application puisse la localiser.

<%@ 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>

L’exemple de code suivant montre comment créer un ImageMap contrôle qui contient des points chauds avec des comportements différents. La zone d’arrière-plan est définie comme un seul RectangleHotSpot qui publie sur le serveur. Trois RectangleHotSpot objets sont définis dans la même région. Chacun de ces points chauds ressemble à un bouton et accède à une URL. Lorsqu’un ImageMap contrôle est cliqué dans une région où deux points chauds se chevauchent, le point chaud déclaré en premier est prioritaire. Dans cet exemple, les points chauds de bouton sont déclarés en premier et le point chaud d’arrière-plan qui les contient est déclaré en dernier. Par conséquent, l’utilisateur obtient le comportement de l’objet button RectangleHotSpot , et non de l’objet d’arrière-plan RectangleHotSpot , quand l’utilisateur clique sur un point chaud de bouton. Pour que cet exemple fonctionne correctement, vous devez fournir votre propre image pour la ImageUrl propriété et mettre à jour le chemin d’accès à l’image de manière appropriée afin que l’application puisse la localiser.

<%@ 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>

Remarques

Dans cette rubrique :

Introduction

Utilisez le ImageMap contrôle pour créer une image qui contient des régions de point chaud définies. Lorsqu’un utilisateur clique sur une région de point chaud, le contrôle peut générer une publication sur le serveur ou accéder à une URL spécifiée. Par exemple, vous pouvez utiliser ce contrôle pour afficher une carte d’une région géographique. Lorsqu’un utilisateur clique sur une région spécifique sur la carte, le contrôle accède à une URL qui fournit des données supplémentaires sur la région sélectionnée. Vous pouvez également utiliser ce contrôle pour générer une publication sur le serveur et exécuter du code spécifique en fonction de la région de point chaud sur laquelle vous avez cliqué. Par exemple, vous pouvez utiliser un ImageMap contrôle pour capturer des réponses utilisateur telles que des votes. Lorsqu’un utilisateur clique sur la région de point chaud définie pour les votes oui, le code est appelé pour enregistrer une réponse oui dans une base de données. Lorsqu’un utilisateur clique sur la région de point chaud définie pour aucun vote, une réponse non est enregistrée. Vous pouvez également combiner ces deux scénarios dans un seul ImageMap contrôle. Par exemple, vous pouvez spécifier une région de point chaud pour accéder à une URL et une autre région de point chaud à publier sur le serveur.

Utilisez la ImageUrl propriété pour spécifier le chemin d’accès à l’image à afficher pour le ImageMap contrôle. Vous pouvez définir n’importe quel nombre d’objets HotSpot au sein d’un ImageMap contrôle. Vous pouvez utiliser les CircleHotSpotclasses , RectangleHotSpotet PolygonHotSpot pour définir des régions de points chauds. Vous pouvez également dériver de la classe abstraite HotSpot pour définir votre propre objet de point chaud personnalisé.

Il existe deux façons de spécifier le comportement d’un HotSpot objet dans un ImageMap contrôle lorsque l’utilisateur HotSpot clique sur. Vous pouvez utiliser la HotSpotMode propriété sur le ImageMap contrôle ou la HotSpotMode propriété sur un objet individuel HotSpot . Ces propriétés sont définies à l’aide de l’une des valeurs d’énumération HotSpotMode . Si les deux propriétés sont définies, la HotSpotMode propriété spécifiée sur chaque objet individuel HotSpot est prioritaire sur la HotSpotMode propriété du ImageMap contrôle.

Pour accéder à une URL, définissez la ImageMap.HotSpotMode propriété ou la propriété sur HotSpotMode.NavigateHotSpot.HotSpotMode . Utilisez la NavigateUrl propriété pour spécifier l’URL à laquelle accéder.

Pour générer une publication sur le serveur, définissez la ImageMap.HotSpotMode propriété ou la propriété sur HotSpot.HotSpotModeHotSpotMode.Postback. Utilisez la PostBackValue propriété pour spécifier un nom pour la région de point chaud. Ce nom sera transmis dans les données d’événement ImageMapEventArgs lorsqu’un événement de publication se produit. Lorsque vous cliquez sur une publication HotSpot , l’événement Click est déclenché. Pour contrôler par programmation les actions effectuées lorsque vous cliquez sur une publication HotSpot , fournissez un gestionnaire d’événements pour l’événement Click .

Pour que tous les HotSpot objets d’un ImageMap contrôle aient le même comportement, utilisez la ImageMap.HotSpotMode propriété pour spécifier le comportement. Ensuite, définissez la HotSpot.HotSpotMode propriété sur chaque objet HotSpotMode.NotSet individuel HotSpot sur ou ne spécifiez pas de valeur pour la HotSpot.HotSpotMode propriété.

Pour spécifier des comportements différents pour HotSpot les objets d’un ImageMap, définissez la HotSpot.HotSpotMode propriété sur chaque objet individuel HotSpot sur HotSpotMode.Navigate ou HotSpotMode.PostBack.

Notes

Si la propriété d’un contrôle ou la HotSpot.HotSpotMode propriété sur l’un HotSpot des objets qu’il contient a HotSpotMode.NotSet la valeur ou n’est pas définie sur une valeur, par défaut, le comportement est HotSpotMode.Navigate.ImageMapImageMap.HotSpotMode

Accessibilité

Pour plus d’informations sur la configuration de ce contrôle afin qu’il génère un balisage conforme aux normes d’accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et ASP.NET contrôles et accessibilité.

Syntaxe déclarative

<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>  

Constructeurs

ImageMap()

Initialise une nouvelle instance de la classe ImageMap.

Propriétés

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web.

(Hérité de WebControl)
Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.

(Hérité de Control)
AlternateText

Obtient ou définit le texte de remplacement affiché dans le contrôle Image lorsque l'image n'est pas disponible. Les navigateurs prenant en charge la fonctionnalité d'info-bulle affichent ce texte sous forme d'info-bulle.

(Hérité de Image)
AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle.

(Hérité de WebControl)
BackColor

Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web.

(Hérité de WebControl)
BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.

(Hérité de Control)
BorderColor

Obtient ou définit la couleur de bordure du contrôle Web.

(Hérité de WebControl)
BorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.

(Hérité de WebControl)
BorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.

(Hérité de WebControl)
ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.

(Hérité de Control)
ClientIDMode

Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID.

(Hérité de Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.

(Hérité de Control)
Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.

(Hérité de Control)
Controls

Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.

(Hérité de Control)
ControlStyle

Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CssClass

Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client.

(Hérité de WebControl)
DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.

(Hérité de Control)
DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.

(Hérité de Control)
DescriptionUrl

Obtient ou définit l'emplacement à une description détaillée pour l'image.

(Hérité de Image)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.

(Hérité de Control)
Enabled

Obtient ou définit une valeur indiquant si un contrôle peut répondre à une interaction utilisateur.

EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle.

(Hérité de WebControl)
EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule.

(Hérité de Control)
Font

Obtient les propriétés de la police du texte associé au contrôle.

(Hérité de Image)
ForeColor

Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web.

(Hérité de WebControl)
GenerateEmptyAlternateText

Obtient ou définit une valeur indiquant si le contrôle génère un autre attribut de texte pour une chaîne vide.

(Hérité de Image)
HasAttributes

Obtient une valeur indiquant si le contrôle a des attributs définis.

(Hérité de WebControl)
HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés.

(Hérité de Control)
Height

Obtient ou définit la hauteur du contrôle serveur Web.

(Hérité de WebControl)
HotSpotMode

Obtient ou définit le comportement par défaut pour les objets HotSpot d'un contrôle ImageMap lorsqu'un clic est effectué sur les objets HotSpot.

HotSpots

Obtient une collection d'objets HotSpot qui représentent les zones réactives définies dans un contrôle ImageMap.

ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.

(Hérité de Control)
ImageAlign

Obtient ou définit l'alignement du contrôle Image par rapport aux autres éléments de la page Web.

(Hérité de Image)
ImageUrl

Obtient ou définit l'URL qui fournit le chemin d'accès d'une image à afficher dans le contrôle Image.

(Hérité de Image)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.

(Hérité de Control)
IsEnabled

Obtient une valeur indiquant si le contrôle est activé.

(Hérité de WebControl)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.

(Hérité de Control)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.

(Hérité de Control)
LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.

(Hérité de Control)
NamingContainer

Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur.

(Hérité de Control)
Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.

(Hérité de Control)
Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.

(Hérité de Control)
Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.

(Hérité de Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.

(Hérité de WebControl)
Style

Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web.

(Hérité de WebControl)
SupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false.

(Hérité de Image)
TabIndex

Obtient ou définit l'index de tabulation du contrôle serveur Web.

(Hérité de WebControl)
TagKey

Obtient la valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
TagName

Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
Target

Obtient ou définit la fenêtre ou le frame cible qui affiche le contenu de la page Web vers laquelle un lien est établi lorsqu'un clic est effectué sur le contrôle ImageMap.

TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.

(Hérité de Control)
ToolTip

Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web.

(Hérité de WebControl)
UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.

(Hérité de Control)
ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses.

(Hérité de Control)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.

(Hérité de Control)
Visible

Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.

(Hérité de Control)
Width

Obtient ou définit la largeur du contrôle serveur web.

(Hérité de WebControl)

Méthodes

AddAttributesToRender(HtmlTextWriter)

Ajoute les attributs et les styles HTML d'un contrôle ImageMap à rendre au HtmlTextWriter spécifié.

AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control.

(Hérité de Control)
AddParsedSubObject(Object)

Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.

(Hérité de Control)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de la page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.

(Hérité de Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearEffectiveClientIDMode()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.

(Hérité de Control)
CopyBaseAttributes(WebControl)

Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CreateChildControls()

Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu.

(Hérité de Control)
CreateControlCollection()

Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.

(Hérité de Control)
CreateControlStyle()

Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

(Hérité de Control)
DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.

(Hérité de Control)
Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée.

(Hérité de Control)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.

(Hérité de Control)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
Focus()

Affecte le focus d'entrée à un contrôle.

(Hérité de Control)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.

(Hérité de Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.

(Hérité de Control)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.

(Hérité de Control)
IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().

(Hérité de Control)
LoadViewState(Object)

Restaure les informations d'état d'affichage du contrôle ImageMap à partir d'une demande de page antérieure enregistrée par la méthode SaveViewState().

MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.

(Hérité de Control)
OnClick(ImageMapEventArgs)

Déclenche l'événement Click pour le contrôle ImageMap.

OnDataBinding(EventArgs)

Déclenche l’événement DataBinding.

(Hérité de Control)
OnInit(EventArgs)

Déclenche l’événement Init.

(Hérité de Control)
OnLoad(EventArgs)

Déclenche l’événement Load.

(Hérité de Control)
OnPreRender(EventArgs)

Déclenche l’événement PreRender.

(Hérité de Control)
OnUnload(EventArgs)

Déclenche l’événement Unload.

(Hérité de Control)
OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.

(Hérité de Control)
RaisePostBackEvent(String)

Déclenche des événements pour le contrôle ImageMap lorsqu'un formulaire est publié sur le serveur.

RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.

(Hérité de Control)
Render(HtmlTextWriter)

Envoie le contenu du contrôle ImageMap à l'objet HtmlTextWriter spécifié, qui écrit le contenu à rendre sur le client.

RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderContents(HtmlTextWriter)

Génère le rendu du contrôle d'image via le writer spécifié.

(Hérité de Image)
RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.

(Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

(Hérité de Control)
RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.

(Hérité de Control)
SaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.

(Hérité de Control)
SaveViewState()

Enregistre les modifications éventuellement apportées à l'état d'affichage du contrôle ImageMap depuis la publication de la page sur le serveur.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TrackViewState()

Suit les modifications d'état d'affichage du contrôle ImageMap afin qu'elles puissent être stockées dans l'objet StateBag du contrôle. Cet objet est accessible via la propriété ViewState.

Événements

Click

Se produit suite à un clic sur un objet HotSpot d'un contrôle ImageMap.

DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.

(Hérité de Control)
Disposed

Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie.

(Hérité de Control)
Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.

(Hérité de Control)
PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.

(Hérité de Control)
Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)

Implémentations d’interfaces explicites

IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.

(Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.

(Hérité de WebControl)
IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.

(Hérité de Control)
IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.

(Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

(Hérité de Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Pour obtenir une description de ce membre, consultez RaisePostBackEvent(String).

Méthodes d’extension

FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.

FindFieldTemplate(Control, String)

Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.

S’applique à

Voir aussi