ImageMap Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea un controllo per la visualizzazione di un'immagine su una pagina. Quando si fa clic su un'area sensibile definita all'interno del controllo ImageMap, il controllo genera un postback per il server o passa a un URL specificato.

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

Ereditarietà: Object

Control

WebControl

Image
ImageMap

Implementazioni: IPostBackEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato come creare in modo dichiarativo un ImageMap controllo contenente due CircleHotSpot oggetti . La HotSpot.HotSpotMode proprietà è impostata su HotSpotMode.Navigate, che fa sì che la pagina passi all'URL specificato ogni volta che un utente fa clic su una delle aree a caldo del cerchio. Per il corretto funzionamento di questo esempio, è necessario specificare la propria immagine per la ImageUrl proprietà e aggiornare il percorso dell'immagine in modo appropriato in modo che l'applicazione possa individuarla.

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

Nell'esempio di codice seguente viene illustrato come creare in modo dichiarativo un ImageMap controllo contenente due RectangleHotSpot oggetti . La ImageMap.HotSpotMode proprietà è impostata su HotSpotMode.PostBack, che determina la postback della pagina al server ogni volta che un utente fa clic su una delle aree ad accesso frequente. Per il corretto funzionamento di questo esempio, è necessario specificare la propria immagine per la ImageUrl proprietà e aggiornare il percorso dell'immagine in modo appropriato in modo che l'applicazione possa individuarla.

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

Nell'esempio di codice seguente viene illustrato come creare un ImageMap controllo contenente aree sensibili con comportamenti diversi. L'area di sfondo è definita come singola RectangleHotSpot che esegue il postback al server. Tre RectangleHotSpot oggetti sono definiti nella stessa area. Ognuno di questi punti caldi è simile a un pulsante e passa a un URL. Quando un ImageMap controllo viene fatto clic in un'area in cui si sovrappongono due punti caldi, il punto di accesso dichiarato ha la precedenza. In questo esempio, i punti caldi del pulsante vengono dichiarati prima e il punto caldo in background che li contiene è dichiarato l'ultimo. Pertanto, l'utente ottiene il comportamento dell'oggetto pulsante RectangleHotSpot , non l'oggetto in background RectangleHotSpot , quando l'utente fa clic su un pulsante a caldo. Per il corretto funzionamento di questo esempio, è necessario specificare la propria immagine per la ImageUrl proprietà e aggiornare il percorso dell'immagine in modo appropriato in modo che l'applicazione possa individuarla.

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

Commenti

In questo argomento

Introduzione
Accessibilità
Sintassi dichiarativa

Introduzione

Usare il ImageMap controllo per creare un'immagine che contiene aree del punto di accesso frequente definite. Quando un utente fa clic su un'area di accesso frequente, il controllo può generare un postback al server o passare a un URL specificato. Ad esempio, è possibile usare questo controllo per visualizzare una mappa di un'area geografica. Quando un utente fa clic su un'area specifica sulla mappa, il controllo passa a un URL che fornisce dati aggiuntivi sull'area selezionata. È anche possibile usare questo controllo per generare un postback nel server ed eseguire codice specifico in base all'area del punto di accesso a cui è stato fatto clic. Ad esempio, è possibile usare un ImageMap controllo per acquisire risposte utente, ad esempio voti. Quando un utente fa clic sull'area di accesso frequente definita per i voti sì, il codice viene chiamato per registrare una risposta sì in un database. Quando un utente fa clic sull'area a caldo definita per nessun voto, non viene registrata alcuna risposta. È anche possibile combinare questi due scenari all'interno di un singolo ImageMap controllo. Ad esempio, è possibile specificare un'area di accesso frequente per passare a un URL e a un'altra area di accesso frequente per eseguire il postback al server.

Utilizzare la ImageUrl proprietà per specificare il percorso dell'immagine da visualizzare per il ImageMap controllo. È possibile definire qualsiasi numero di oggetti all'interno di HotSpot un ImageMap controllo. È possibile usare le CircleHotSpotclassi , RectangleHotSpote PolygonHotSpot per definire le aree ad accesso frequente. In alternativa, è possibile derivare dalla classe astratta HotSpot per definire un oggetto hot spot personalizzato.

Esistono due modi per specificare il comportamento di un oggetto in un HotSpot ImageMap controllo quando viene HotSpot fatto clic. È possibile usare la HotSpotMode proprietà sul ImageMap controllo o la HotSpotMode proprietà in un singolo HotSpot oggetto. Queste proprietà vengono impostate usando uno dei valori di HotSpotMode enumerazione. Se entrambe le proprietà vengono impostate, la proprietà specificata in ogni singolo HotSpot oggetto ha la HotSpotMode precedenza sulla proprietà sul HotSpotMode ImageMap controllo.

Per passare a un URL, impostare la proprietà o la ImageMap.HotSpotMode HotSpot.HotSpotMode proprietà su HotSpotMode.Navigate. Utilizzare la NavigateUrl proprietà per specificare l'URL da passare.

Per generare un postback al server, impostare la proprietà o la ImageMap.HotSpotMode HotSpot.HotSpotMode proprietà su HotSpotMode.Postback. Utilizzare la PostBackValue proprietà per specificare un nome per l'area del punto di accesso frequente. Questo nome verrà passato nei dati dell'evento ImageMapEventArgs quando si verifica un evento postback. Quando viene fatto clic su un postback HotSpot , viene generato l'evento Click . Per controllare a livello di codice le azioni eseguite quando viene fatto clic su un postback HotSpot , specificare un gestore eventi per l'evento Click .

Per causare che tutti gli HotSpot oggetti in un ImageMap controllo abbiano lo stesso comportamento, usare la ImageMap.HotSpotMode proprietà per specificare il comportamento. Impostare quindi la HotSpot.HotSpotMode proprietà su ogni singolo HotSpot oggetto HotSpotMode.NotSet o non specificare un valore per la HotSpot.HotSpotMode proprietà.

Per specificare comportamenti diversi per HotSpot gli oggetti in un ImageMapoggetto , impostare la HotSpot.HotSpotMode proprietà su ogni singolo HotSpot oggetto HotSpotMode.Navigate o HotSpotMode.PostBack.

Nota

Se la ImageMap proprietà o la HotSpot.HotSpotMode proprietà di ImageMap.HotSpotMode un controllo in uno degli HotSpot oggetti che contiene è impostata su HotSpotMode.NotSet o non è impostata su un valore, per impostazione predefinita il comportamento è HotSpotMode.Navigate.

Accessibilità

Per informazioni su come configurare questo controllo in modo che generi markup conforme agli standard di accessibilità, vedere Accessibilità in Visual Studio e ASP.NET e controlli ASP.NET e accessibilità.

Sintassi dichiarativa

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

Costruttori

ImageMap()

Inizializza una nuova istanza della classe ImageMap.

Proprietà

AccessKey	Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web. (Ereditato da WebControl)
Adapter	Ottiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
AlternateText	Ottiene o imposta il testo alternativo visualizzato nel controllo Image quando l'immagine non è disponibile. Nei browser che supportano la funzione di descrizione comandi, il testo viene visualizzato come descrizione. (Ereditato da Image)
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
Attributes	Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
BackColor	Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
BindingContainer	Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
BorderColor	Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
BorderStyle	Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
BorderWidth	Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
ChildControlsCreated	Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID. (Ereditato da Control)
ClientIDSeparator	Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control)
ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlStyleCreated	Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CssClass	Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. (Ereditato da WebControl)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DescriptionUrl	Ottiene o imposta la posizione su una descrizione dettagliata dell'immagine. (Ereditato da Image)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Enabled	Ottiene o imposta un valore che indica se il controllo può rispondere all'interazione dell'utente.
EnableTheming	Ottiene o imposta un valore che indica se al controllo vengono applicati i temi. (Ereditato da WebControl)
EnableViewState	Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control)
Events	Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control)
Font	Ottiene le proprietà dei caratteri per il testo associato al controllo. (Ereditato da Image)
ForeColor	Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. (Ereditato da WebControl)
GenerateEmptyAlternateText	Ottiene o imposta un valore che indica se il controllo genera un attributo di testo alternativo per un valore di stringa vuota. (Ereditato da Image)
HasAttributes	Ottiene un valore che indica se sono impostati attributi per il controllo. (Ereditato da WebControl)
HasChildViewState	Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
HotSpotMode	Ottiene o imposta il comportamento predefinito degli oggetti HotSpot di un controllo ImageMap quando viene fatto clic sugli oggetti HotSpot.
HotSpots	Ottiene un insieme di oggetti HotSpot che rappresenta le aree sensibili definite di un controllo ImageMap.
ID	Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
ImageAlign	Ottiene o imposta l'allineamento del controllo Image in relazione ad altri elementi della pagina Web. (Ereditato da Image)
ImageUrl	Ottiene o imposta l'URL che fornisce il percorso di un'immagine da visualizzare nel controllo Image. (Ereditato da Image)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control)
IsEnabled	Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control)
LoadViewStateByID	Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID. (Ereditato da Control)
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
RenderingCompatibility	Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control)
Site	Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da WebControl)
Style	Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo `disabled` dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è `false`. (Ereditato da Image)
TabIndex	Ottiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl)
TagKey	Ottiene il valore HtmlTextWriterTag corrispondente al controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TagName	Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Target	Ottiene o imposta la finestra o il frame di destinazione in cui viene visualizzato il contenuto della pagina Web collegato quando viene fatto clic sul controllo ImageMap.
TemplateControl	Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control)
ToolTip	Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl)
UniqueID	Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control)
ViewState	Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come interfaccia utente nella pagina. (Ereditato da Control)
Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)

Metodi

AddAttributesToRender(HtmlTextWriter)	Aggiunge gli attributi e gli stili HTML di un controllo ImageMap di cui è necessario eseguire il rendering nell'oggetto HtmlTextWriter specificato.
AddedControl(Control, Int32)	Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control. (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control)
ApplyStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ApplyStyleSheetSkin(Page)	Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella cache ClientID su `null`. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
CopyBaseAttributes(WebControl)	Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateChildControls()	Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering. (Ereditato da Control)
CreateControlCollection()	Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server. (Ereditato da Control)
CreateControlStyle()	Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio. (Ereditato da Control)
DataBind(Boolean)	Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control)
DataBindChildren()	Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control)
Dispose()	Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String)	Cerca un controllo server nel contenitore dei nomi corrente con il parametro `id` specificato. (Ereditato da Control)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro `id` indicato e un intero, specificato nel parametro `pathOffset`, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl. (Ereditato da Control)
Focus()	Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control)
GetDesignModeState()	Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio. (Ereditato da Control)
IsLiteralContent()	Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState(). (Ereditato da Control)
LoadViewState(Object)	Ripristina le informazioni sullo stato di visualizzazione per il controllo ImageMap da una richiesta di pagina precedente salvata dal metodo SaveViewState().
MapPathSecure(String)	Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MergeStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina. (Ereditato da Control)
OnClick(ImageMapEventArgs)	Genera l'evento Click per il controllo ImageMap.
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da Control)
OnInit(EventArgs)	Genera l'evento Init. (Ereditato da Control)
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnPreRender(EventArgs)	Genera l'evento PreRender. (Ereditato da Control)
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OpenFile(String)	Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)	Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
RaisePostBackEvent(String)	Genera eventi per il controllo ImageMap durante il postback di un form nel server.
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control. (Ereditato da Control)
Render(HtmlTextWriter)	Invia il contenuto del controllo ImageMap all'oggetto HtmlTextWriter specificato che scrive il contenuto di cui eseguire il rendering sul client.
RenderBeginTag(HtmlTextWriter)	Esegue il rendering del tag HTML di apertura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderContents(HtmlTextWriter)	Esegue il rendering del contenuto del controllo immagine nel writer specificato. (Ereditato da Image)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ResolveAdapter()	Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
SaveControlState()	Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server. (Ereditato da Control)
SaveViewState()	Salva le eventuali modifiche apportate allo stato di visualizzazione di un controllo ImageMap dopo l'ultimo postback della pagina al server.
SetDesignModeState(IDictionary)	Imposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Tiene traccia delle variazioni dello stato di visualizzazione del controllo ImageMap in modo che possano essere archiviate nell'oggetto StateBag del controllo. È possibile accedere a questo oggetto tramite la proprietà ViewState.

Eventi

Click	Si verifica quando viene fatto clic su un oggetto HotSpot in un controllo ImageMap.
DataBinding	Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Disposed	Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
Load	Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
Unload	Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)	Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)	Imposta un attributo del controllo Web sul nome e il valore specificati. (Ereditato da WebControl)
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Per una descrizione di questo membro, vedere RaisePostBackEvent(String).

Metodi di estensione

FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatabella per il controllo contenitore dei dati.

Si applica a

Condividi tramite