HotSpotCollection Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

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

Stellt eine Auflistung von HotSpot-Objekten in einem ImageMap-Steuerelement dar. Diese Klasse kann nicht vererbt werden.

public ref class HotSpotCollection sealed : System::Web::UI::StateManagedCollection

public sealed class HotSpotCollection : System.Web.UI.StateManagedCollection

type HotSpotCollection = class
    inherit StateManagedCollection

Public NotInheritable Class HotSpotCollection
Inherits StateManagedCollection

Vererbung: Object

StateManagedCollection
HotSpotCollection

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Ein Steuerelement programmgesteuert erstellt ImageMap und zwei CircleHotSpot Objekte hinzugefügt werden. Die HotSpots Eigenschaft wird verwendet, um auf die HotSpotCollection Auflistung für das ImageMap Steuerelement zuzugreifen und die CircleHotSpot Objekte hinzuzufügen. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie Ihr eigenes Bild für die ImageUrl Eigenschaft angeben und den Pfad zum Bild entsprechend aktualisieren, damit die Anwendung es finden kann.

<%@ 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 Page_Load (Object sender, EventArgs e)
  {
    // Programmatically create an ImageMap control.
    ImageMap Shop = new ImageMap();
    
    // Set properties on the ImageMap control.
    Shop.ImageUrl = "Images/ShopChoice.jpg";
    Shop.AlternateText = "Shopping choices";

    // Add the ImageMap control to the 
    // Controls collection of the page.
    Page.Controls.Add(Shop);

    // Programmatically create a CircleHotSpot object.
    CircleHotSpot Circle1 = new CircleHotSpot();
    Circle1.HotSpotMode = HotSpotMode.Navigate;
    Circle1.NavigateUrl = "http://www.tailspintoys.com";
    Circle1.X = 145;
    Circle1.Y = 120;
    Circle1.Radius = 75;
    Circle1.AlternateText = "Shop for toys";

    // Add Circle1 to the ImageMap's HotSpotCollection.    
    Shop.HotSpots.Add(Circle1);

    // Programmatically create a second CircleHotSpot object.
    CircleHotSpot Circle2 = new CircleHotSpot();
    Circle2.HotSpotMode = HotSpotMode.Navigate;
    Circle2.NavigateUrl = "http://www.cohowinery.com";
    Circle2.X = 145;
    Circle2.Y = 290;
    Circle2.Radius = 75;
    Circle2.AlternateText = "Shop for wine";

    // Add Circle2 to the ImageMap's HotSpotCollection.    
    Shop.HotSpots.Add(Circle2);
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class C# Constructor Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class C# Constructor Example</h3>
      
      <h4>Shopping Choices:</h4>
      
    </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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    
    ' Programmatically create an ImageMap control.
    Dim Shop As New ImageMap
    Shop.ImageUrl = "Images/ShopChoice.jpg"
    Shop.AlternateText = "Shopping choices"
    
    ' Add the ImageMap control to the 
    ' Controls collection of the page.
    Page.Controls.Add(Shop)
    
    ' Programmatically create a CircleHotSpot object.
    Dim Circle1 As New CircleHotSpot
    Circle1.HotSpotMode = HotSpotMode.Navigate
    Circle1.NavigateUrl = "http://www.tailspintoys.com"
    Circle1.X = 145
    Circle1.Y = 120
    Circle1.Radius = 75
    Circle1.AlternateText = "Shop for toys"
    
    ' Add Circle1 to the ImageMap's HotSpotCollection.    
    Shop.HotSpots.Add(Circle1)
    
    ' Programmatically create a second CircleHotSpot object.
    Dim Circle2 As New CircleHotSpot
    Circle2.HotSpotMode = HotSpotMode.Navigate
    Circle2.NavigateUrl = "http://www.cohowinery.com"
    Circle2.X = 145
    Circle2.Y = 290
    Circle2.Radius = 75
    Circle2.AlternateText = "Shop for wine"

    
    ' Add Circle2 to the ImageMap's HotSpotCollection.    
    Shop.HotSpots.Add(Circle2)
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class VB Constructor Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class VB Constructor Example</h3>
      
      <h4>Shopping Choices:</h4>
      
    </form>      
  </body>
</html>

Hinweise

Die HotSpotCollection Klasse stellt eine Auflistung dar, mit der ein ImageMap Steuerelement eine Liste der HotSpot darin enthaltenen Objekte verwalten kann.

Verwenden Sie die Add Methode, um der Auflistung am Ende eines Ordnungsindexarrays ein angegebenes HotSpot Objekt hinzuzufügen. Verwenden Sie die Insert Methode, um der Auflistung an einer angegebenen Indexposition ein HotSpot Objekt hinzuzufügen. Verwenden Sie den Item[] Indexer, um direkt auf ein HotSpot Objekt in der Auflistung bei einem angegebenen Index zuzugreifen, indem Sie einfache Arraynotation verwenden.

Verwenden Sie die Remove Methode, um ein HotSpot Objekt vom Ende der Auflistung zu entfernen. Verwenden Sie die RemoveAt Methode, um ein HotSpot Objekt aus einer angegebenen Indexposition zu entfernen.

Konstruktoren

HotSpotCollection()

Initialisiert eine neue Instanz der HotSpotCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Geerbt von StateManagedCollection)
Item[Int32]	Ruft einen Verweis auf das HotSpot-Objekt am angegebenen Index in der HotSpotCollection-Auflistung ab.

Methoden

Add(HotSpot)	Fügt ein angegebenes HotSpot-Objekt an das Ende der HotSpotCollection-Auflistung an.
Clear()	Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
CopyTo(Array, Int32)	Kopiert die Elemente der StateManagedCollection-Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird. (Geerbt von StateManagedCollection)
CreateKnownType(Int32)	Beim Überschreiben in einer abgeleiteten Klasse wird eine Instanz einer Klasse erstellt, die IStateManager implementiert. Der Typ des erstellten Objekts basiert auf dem angegebenen Element der Auflistung, der von der GetKnownTypes()-Methode zurückgegeben wird. (Geerbt von StateManagedCollection)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Geerbt von StateManagedCollection)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetKnownTypes()	Beim Überschreiben in einer abgeleiteten Klasse wird ein Array von IStateManager-Typen abgerufen, die die StateManagedCollection-Auflistung enthalten kann. (Geerbt von StateManagedCollection)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Insert(Int32, HotSpot)	Fügt ein angegebenes HotSpot-Objekt an der angegebenen Indexposition in die HotSpotCollection-Auflistung ein.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnClear()	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Clear()-Methode alle Elemente aus der Auflistung entfernt. (Geerbt von StateManagedCollection)
OnClearComplete()	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die Clear()-Methode alle Elemente aus der Auflistung entfernt hat. (Geerbt von StateManagedCollection)
OnInsert(Int32, Object)	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die IList.Insert(Int32, Object)-Methode oder die IList.Add(Object)-Methode der Auflistung ein Element hinzufügt. (Geerbt von StateManagedCollection)
OnInsertComplete(Int32, Object)	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die IList.Insert(Int32, Object)-Methode oder die IList.Add(Object)-Methode der Auflistung ein Element hinzugefügt hat. (Geerbt von StateManagedCollection)
OnRemove(Int32, Object)	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die IList.Remove(Object)-Methode oder die IList.RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt. (Geerbt von StateManagedCollection)
OnRemoveComplete(Int32, Object)	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die IList.Remove(Object)-Methode oder die IList.RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt hat. (Geerbt von StateManagedCollection)
OnValidate(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Element der StateManagedCollection-Auflistung validiert. (Geerbt von StateManagedCollection)
Remove(HotSpot)	Entfernt das angegebene HotSpot-Objekt aus der HotSpotCollection-Auflistung.
RemoveAt(Int32)	Entfernt das HotSpot-Objekt an der angegebenen Indexposition aus der Auflistung.
SetDirty()	Erzwingt den serialisierten Ansichtszustand für die gesamte StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
SetDirtyObject(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein in der Auflistung enthaltenes `object` angewiesen, seinen gesamten Zustand im Ansichtszustand aufzuzeichnen, anstatt nur die Änderungsinformationen aufzuzeichnen. (Geerbt von StateManagedCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.Count	Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Geerbt von StateManagedCollection)
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung synchronisiert (threadsicher) ist. Diese Methode gibt immer `false` zurück. (Geerbt von StateManagedCollection)
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die StateManagedCollection-Auflistung synchronisiert werden kann. Diese Methode gibt immer `null` zurück. (Geerbt von StateManagedCollection)
IEnumerable.GetEnumerator()	Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Geerbt von StateManagedCollection)
IList.Add(Object)	Fügt der StateManagedCollection-Auflistung ein Element hinzu. (Geerbt von StateManagedCollection)
IList.Clear()	Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
IList.Contains(Object)	Ermittelt, ob die StateManagedCollection-Auflistung einen bestimmten Wert enthält. (Geerbt von StateManagedCollection)
IList.IndexOf(Object)	Bestimmt den Index eines bestimmten Elements in der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
IList.Insert(Int32, Object)	Fügt ein Element am angegebenen Index in die StateManagedCollection-Auflistung ein. (Geerbt von StateManagedCollection)
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung eine feste Größe aufweist. Diese Methode gibt immer `false` zurück. (Geerbt von StateManagedCollection)
IList.IsReadOnly	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung schreibgeschützt ist. (Geerbt von StateManagedCollection)
IList.Item[Int32]	Ruft das IStateManager-Element am angegebenen Index ab. (Geerbt von StateManagedCollection)
IList.Remove(Object)	Entfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
IList.RemoveAt(Int32)	Entfernt das IStateManager-Element am angegebenen Index. (Geerbt von StateManagedCollection)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung Änderungen des Ansichtszustands speichert. (Geerbt von StateManagedCollection)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der StateManagedCollection-Auflistung und der in ihr enthaltenen IStateManager-Elemente wieder her. (Geerbt von StateManagedCollection)
IStateManager.SaveViewState()	Speichert die Änderungen an der StateManagedCollection-Auflistung und allen darin enthaltenen IStateManager-Objekten seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von StateManagedCollection)
IStateManager.TrackViewState()	Weist die StateManagedCollection-Auflistung und alle in ihr enthaltenen IStateManager-Objekte an, die Änderungen im Ansichtszustand nachzuverfolgen, sodass diese für die gleiche Seite anforderungsübergreifend beibehalten werden können. (Geerbt von StateManagedCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für