AdRotator Klasse

Definition

Zeigt ein Werbebanner auf einer Webseite an.

public ref class AdRotator : System::Web::UI::WebControls::WebControl
public ref class AdRotator : System::Web::UI::WebControls::DataBoundControl
public class AdRotator : System.Web.UI.WebControls.WebControl
public class AdRotator : System.Web.UI.WebControls.DataBoundControl
type AdRotator = class
    inherit WebControl
type AdRotator = class
    inherit DataBoundControl
Public Class AdRotator
Inherits WebControl
Public Class AdRotator
Inherits DataBoundControl
Vererbung
Vererbung

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe des AdRotator Steuerelements ein Werbebanner auf einer Webseite anzeigen.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 
 <head runat="server">
    <title>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 
 <head runat="server">
    <title>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

Das folgende Codebeispiel veranschaulicht das Dateiformat für eine XML-Datei, die Ankündigungsinformationen für das vorherige Beispiel enthält. Weitere Informationen zum Dateiformat finden Sie im AdvertisementFile Element.

<Advertisements>  
  <Ad>  
    <ImageUrl>~/Images/image1.jpg</ImageUrl>  
    <height>60</height>  
    <width>190</width>  
    <NavigateUrl>http://www.microsoft.com</NavigateUrl>  
    <AlternateText>Microsoft Main Site</AlternateText>  
    <Impressions>80</Impressions>  
    <Keyword>Topic1</Keyword>  
  </Ad>  
  <Ad>  
    <ImageUrl>~/Images/image2.jpg</ImageUrl>  
    <height>90</height>  
    <width>90</width>  
    <NavigateUrl>http://www.wingtiptoys.com</NavigateUrl>  
    <AlternateText>Wingtip Toys</AlternateText>  
    <Impressions>80</Impressions>  
    <Keyword>Topic2</Keyword>  
  </Ad>  
</Advertisements>  

Hinweise

In diesem Thema:

Einführung

Verwenden Sie das AdRotator Steuerelement, um ein zufällig ausgewähltes Werbebanner auf der Webseite anzuzeigen. Die angezeigte Ankündigung ändert sich immer dann, wenn die Seite aktualisiert wird.

Werbeinformationen werden in einer separaten XML-Datei gespeichert. Mit der XML-Datei können Sie eine Liste von Ankündigungen und den zugehörigen Attributen verwalten. Zu den Attributen gehören der Pfad zu einem anzuzeigenden Bild, die URL, mit der beim Klicken auf das Steuerelement verknüpft werden soll, der alternative Text, der angezeigt werden soll, wenn das Bild nicht verfügbar ist, ein Schlüsselwort (keyword) und die Häufigkeit der Ankündigung. Die Informationen in dieser Datei werden vom AdRotator Steuerelement nicht überprüft. Um zu verhindern, dass Anzeigen böswillige Skripts ausführen, sollten Sie die Daten immer überprüfen, bevor Sie sie veröffentlichen, oder Anzeigeninformationen nur von vertrauenswürdigen Quellen akzeptieren.

Führen Sie eine oder mehrere der folgenden Schritte aus, um Ihre Werbedatei vor nicht autorisiertem Internetzugriff zu schützen:

  • Speichern Sie sie im Verzeichnis App_Data, das so konfiguriert ist, dass der Internetzugriff für Dateien eines beliebigen Typs verweigert wird.
  • Benennen Sie die Datei mit einer Erweiterung um, die nicht .xml ist, und ordnen Sie die Erweiterung in HttpForbiddenHandler Web.config zu. Weitere Informationen finden Sie im httpHandlers Abschnitt ihrer Machine.config-Datei.

Alternativ zu einer XML-Datei als Datenquelle ist es möglich, Werbeinformationen über ein Rückrufereignis bereitzustellen. Dieses Ereignis kann auch in Kombination mit der XML-Datei verwendet werden, um das Verhalten des AdRotator Steuerelements zu erweitern, z. B. das Umleiten auf eine andere Seite. AdvertisementFile Weitere Informationen zum Dateiformat finden Sie in der -Eigenschaft.

Hinweis

Wenn die Seitenzwischenspeicherung aktiviert ist, wird ein AdRotator Steuerelement nicht zwischengespeichert. Eine neue Ankündigung wird immer dann ausgewählt, wenn die Webseite aktualisiert wird. Eine neue Ankündigung wird jedoch nicht ausgewählt, wenn Sie einen Ereignishandler für das AdCreated Ereignis bereitstellen.

XML-Ankündigungsdateiformat

Das AdRotator Steuerelement verwendet eine separate XML-Ankündigungsdatei, um die Werbeinformationen zu speichern, z. B. den Speicherort des anzuzeigenden Bilds und die URL der Seite, auf die eine Verknüpfung hergestellt werden soll. Die AdvertisementFile -Eigenschaft des AdRotator -Steuerelements gibt den Pfad zu dieser Datei an.

Beim Erstellen der Ankündigungsdatei markieren öffnende und schließende <Advertisements> Tags den Anfang bzw. das Ende der Datei. Öffnende und schließende <Ad> Tags trennen jede Ankündigung. Alle Anzeigen werden zwischen den öffnenden und schließenden <Advertisements> Tags geschachtelt. Wenn die Datei mehrere <Advertisements> Tags enthält, wird nur der erste Satz von <Advertisements> Tags in der Datei vom AdRotator Steuerelement analysiert. Alle anderen <Advertisements> Tags werden ignoriert.

Die Datenelemente für jede Ankündigung werden zwischen den öffnenden und schließenden <Ad> Tags geschachtelt. Obwohl bestimmte Datenelemente vordefiniert sind (z ImageUrl . B. und NavigateUrl), können Sie benutzerdefinierte Elemente zwischen den <Ad> Tags platzieren. Diese Elemente werden vom AdRotator Steuerelement gelesen, wenn es die Datei analysiert. Die Informationen werden dann in der Dictionary-Eigenschaft an das AdCreatedAdProperties Ereignis übergeben.

In der folgenden Tabelle sind die Datenelemente aufgeführt, die für die XML-Ankündigungsdatei vordefiniert sind.

Element BESCHREIBUNG
ImageUrl Die absolute oder relative URL zu einer Bilddatei (optional).
NavigateUrl Die URL einer Seite, auf die verlinkt werden soll, wenn der Benutzer auf die Anzeige klickt (optional). Hinweis: Wenn dieses Element nicht festgelegt ist, wird die HRef -Eigenschaft nicht für das Ankertag gerendert.
Height Die Höhe des Bilds in Pixel (optional).
Width Die Breite des Bilds in Pixel (optional).
AlternateText Der Text wird anstelle des Bilds angezeigt, wenn das durch die ImageUrl -Eigenschaft angegebene Bild nicht verfügbar ist (optional).

In einigen Browsern wird dieser Text auch als eine ToolTip für die Werbung angezeigt.
Keyword Eine Kategorie für die Werbung (z. B. "Computer"), nach der Sie filtern können (optional).
Impressions Eine Zahl, die die Bedeutung der Anzeige im Zeitplan der Drehung relativ zu den anderen Anzeigen in der Datei angibt (optional).

Je größer die Zahl, desto häufiger wird die Anzeige angezeigt. Die Gesamtsumme aller <Impressions> Werte in der XML-Datei darf 2.047.999.999 nicht überschreiten. Wenn dies der Fall ist, löst das AdRotator Steuerelement eine Laufzeit-Ausnahme aus.

Das folgende Beispiel zeigt das Format für die XML-Ankündigungsdatei.

<Advertisements>  
  <Ad>  
    <ImageUrl>  
      URL of image to display for Advertisement #1  
    </ImageUrl>  
    <NavigateUrl>  
      URL of page to link to for Advertisement #1  
    </NavigateUrl>  
    <AlternateText>  
      Text to show as a ToolTip for Advertisement #1  
    </AlternateText>  
    <Keyword>  
      Keyword used to filter for Advertisement #1  
    </Keyword>  
    <Impressions>  
       Relative importance of Advertisement #1  
    </Impressions>  
    <CustomInformation>  
      Custom Data about Advertisement #1  
    </CustomInformation>  
  </Ad>  
</Advertisements>  

Deklarative Syntax

<asp:AdRotator  
    AccessKey="string"  
    AdvertisementFile="uri"  
    AlternateTextField="string"  
    BackColor="color name|#dddddd"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    CssClass="string"  
    DataMember="string"  
    DataSource="string"  
    DataSourceID="string"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ForeColor="color name|#dddddd"  
    Height="size"  
    ID="string"  
    ImageUrlField="string"  
    KeywordFilter="string"  
    NavigateUrlField="string"  
    OnAdCreated="AdCreated event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDataBound="DataBound 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|_blank|_parent|_search|_self|_top"  
    ToolTip="string"  
    Visible="True|False"  
    Width="size"  
/>  

Konstruktoren

AdRotator()

Initialisiert eine neue Instanz der AdRotator-Klasse.

Eigenschaften

AccessKey

Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest.

(Geerbt von WebControl)
Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
AdvertisementFile

Ruft den Pfad einer XML-Datei mit Informationen über die Werbung ab oder legt diesen fest.

AlternateTextField

Ruft ein benutzerdefiniertes Datenfeld ab, das anstelle des AlternateText-Attributs für eine Werbung verwendet werden soll, oder legt dieses fest.

AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.

(Geerbt von Control)
Attributes

Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen.

(Geerbt von WebControl)
BackColor

Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.

(Geerbt von Control)
BorderColor

Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BorderStyle

Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BorderWidth

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.

(Geerbt von Control)
ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.

(Geerbt von Control)
Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.

(Geerbt von Control)
ControlStyle

Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ControlStyleCreated

Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CssClass

Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest.

(Geerbt von WebControl)
DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.

(Geerbt von Control)
DataMember

Ruft den Namen der Datenliste ab, an die das datengebundene Steuerelement gebunden wird, wenn die Datenquelle mehrere Listen von Datenelementen enthält, oder legt diesen fest.

(Geerbt von DataBoundControl)
DataSource

Ruft das Objekt ab, aus dem das datengebundene Steuerelement seine Liste mit Datenelementen abruft, oder legt dieses fest.

(Geerbt von BaseDataBoundControl)
DataSourceID

Dient zum Abrufen oder Festlegen der ID des Steuerelements, aus dem das datengebundene Steuerelement seine Liste mit Datenelementen abruft.

(Geerbt von DataBoundControl)
DataSourceObject

Ruft ein Objekt ab, das die IDataSource-Schnittstelle implementiert, die Zugriff auf den Dateninhalt des Objekts bereitstellt.

(Geerbt von DataBoundControl)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.

(Geerbt von Control)
Enabled

Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest.

(Geerbt von WebControl)
EnableTheming

Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest.

(Geerbt von WebControl)
EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Control)
Font

Ruft die Schriftarteigenschaften ab, die dem Werbebannersteuerelement zugeordnet sind.

ForeColor

Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest.

(Geerbt von WebControl)
HasAttributes

Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden.

(Geerbt von WebControl)
HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.

(Geerbt von Control)
Height

Ruft die Höhe des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.

(Geerbt von Control)
ImageUrlField

Ruft ein benutzerdefiniertes Datenfeld ab, das anstelle des ImageUrl-Attributs für eine Werbung verwendet werden soll, oder legt dieses fest.

Initialized

Ruft einen Wert ab, der angibt, ob das datengebundene Steuerelement initialisiert wurde.

(Geerbt von BaseDataBoundControl)
IsBoundUsingDataSourceID

Ruft einen Wert ab, der angibt, ob die DataSourceID-Eigenschaft festgelegt ist.

(Geerbt von BaseDataBoundControl)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.

(Geerbt von Control)
IsDataBindingAutomatic

Ruft einen Wert ab, der angibt, ob die Datenbindung automatisch erfolgt.

(Geerbt von BaseDataBoundControl)
IsEnabled

Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist.

(Geerbt von WebControl)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.

(Geerbt von Control)
IsUsingModelBinders

Ruft einen Wert ab, der angibt, ob Modellbindung gegenwärtig verwendet wird.

(Geerbt von DataBoundControl)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.

(Geerbt von Control)
ItemType

Ruft den Namen des Datenelementtyps für stark typisierte Datenbindung ab oder legt diesen fest.

(Geerbt von DataBoundControl)
KeywordFilter

Ruft ein Kategorieschlüsselwort zum Filtern nach bestimmten Werbungstypen in der XML-Datei für die Werbung ab oder legt dieses fest.

LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.

(Geerbt von Control)
NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.

(Geerbt von Control)
NavigateUrlField

Ruft ein benutzerdefiniertes Datenfeld ab, das anstelle des NavigateUrl-Attributs für eine Werbung verwendet werden soll, oder legt dieses fest.

Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.

(Geerbt von Control)
RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.

(Geerbt von Control)
RequiresDataBinding

Ruft einen Wert ab, der angibt, ob die DataBind()-Methode aufgerufen werden soll, oder legt diesen fest.

(Geerbt von BaseDataBoundControl)
SelectArguments

Ruft ein DataSourceSelectArguments-Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellen-Steuerelement verwendet wird.

(Geerbt von DataBoundControl)
SelectMethod

Der Name der Methode, die aufgerufen werden soll, um Daten zu lesen.

(Geerbt von DataBoundControl)
Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.

(Geerbt von Control)
SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.

(Geerbt von WebControl)
Style

Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden.

(Geerbt von WebControl)
SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist.

(Geerbt von WebControl)
SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist.

(Geerbt von BaseDataBoundControl)
TabIndex

Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.

(Geerbt von WebControl)
TagKey

Ruft das HTML-Tag für das AdRotator-Steuerelement ab.

TagKey

Ruft den HtmlTextWriterTag-Wert ab, der diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
TagName

Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
Target

Ruft den Namen des Fensters bzw. Frames im Browser ab, in dem der Inhalt der beim Klicken auf das AdRotator-Steuerelement aufgerufenen Webseite angezeigt wird, oder legt diesen fest.

TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.

(Geerbt von Control)
ToolTip

Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest.

(Geerbt von WebControl)
UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das AdRotator-Steuerelement ab.

UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.

(Geerbt von Control)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.

(Geerbt von Control)
Visible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.

(Geerbt von Control)
Width

Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest.

(Geerbt von WebControl)

Methoden

AddAttributesToRender(HtmlTextWriter)

Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.

(Geerbt von Control)
ApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.

(Geerbt von Control)
ConfirmInitState()

Legt den initialisierten Zustand des datengebundenen Steuerelements fest.

(Geerbt von BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.

CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.

(Geerbt von Control)
CreateControlStyle()

Erstellt das Formatvorlagenobjekt, das von der WebControl-Klasse intern zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften verwendet wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CreateDataSourceSelectArguments()

Erstellt ein vom datengebundenen Steuerelement verwendetes DataSourceSelectArguments-Standardobjekt, wenn keine Argumente angegeben wurden.

(Geerbt von DataBoundControl)
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.

(Geerbt von Control)
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.

(Geerbt von BaseDataBoundControl)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

(Geerbt von Control)
EnsureDataBound()

Ruft die DataBind()-Methode auf, wenn die DataSourceID-Eigenschaft festgelegt und das datengebundene Steuerelement so markiert ist, dass es eine Bindung erfordert.

(Geerbt von BaseDataBoundControl)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.

(Geerbt von Control)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.

(Geerbt von Control)
GetData()

Ruft ein DataSourceView-Objekt ab, mit dessen Hilfe das datengebundene Steuerelement Datenvorgänge ausführt.

(Geerbt von DataBoundControl)
GetDataSource()

Ruft die IDataSource-Schnittstelle ab, der das datengebundene Steuerelement zugeordnet ist (falls vorhanden).

(Geerbt von DataBoundControl)
GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.

(Geerbt von Control)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.

(Geerbt von Control)
HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.

(Geerbt von Control)
IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.

(Geerbt von Control)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.

(Geerbt von Control)
LoadViewState(Object)

Stellt Ansichtszustandsinformationen von einer vorherigen Anforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurde.

(Geerbt von WebControl)
LoadViewState(Object)

Stellt die Informationen über den Ansichtszustand aus einer früheren Seitenanforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden.

(Geerbt von DataBoundControl)
MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.

(Geerbt von Control)
MarkAsDataBound()

Legt den Zustand des Steuerelements im Ansichtszustand als erfolgreich an Daten gebunden fest.

(Geerbt von DataBoundControl)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MergeStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
OnAdCreated(AdCreatedEventArgs)

Löst das AdCreated-Ereignis für das AdRotator-Steuerelement aus.

OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.

(Geerbt von Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Löst das CreatingModelDataSource-Ereignis aus.

(Geerbt von DataBoundControl)
OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.

(Geerbt von Control)
OnDataBound(EventArgs)

Löst das DataBound-Ereignis aus.

(Geerbt von BaseDataBoundControl)
OnDataPropertyChanged()

Bindet das datengebundene Steuerelement nach einer Änderung der Eigenschaften zum Angeben der Basisdatenquelle erneut an die Daten.

(Geerbt von DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Löst das DataSourceViewChanged-Ereignis aus.

(Geerbt von DataBoundControl)
OnInit(EventArgs)

Löst das Init-Ereignis aus.

OnInit(EventArgs)

Löst das Init-Ereignis aus.

(Geerbt von Control)
OnLoad(EventArgs)

Löst das Load-Ereignis aus.

(Geerbt von Control)
OnLoad(EventArgs)

Behandelt das Load-Ereignis.

(Geerbt von DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Legt den initialisierten Zustand des datengebundenen Steuerelements fest, bevor das Steuerelement geladen wird.

(Geerbt von DataBoundControl)
OnPreRender(EventArgs)

Ruft die Informationen über die Werbung zum Rendern durch Suchen nach den Dateidaten oder Aufrufen des Benutzerereignisses ab.

OnUnload(EventArgs)

Löst das Unload-Ereignis aus.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.

(Geerbt von Control)
PerformDataBinding(IEnumerable)

Bindet die angegebene Datenquelle an das AdRotator-Steuerelement.

PerformSelect()

Ruft die Daten über die Werbung von der zugeordneten Datenquelle ab.

RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.

(Geerbt von Control)
RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.

(Geerbt von Control)
Render(HtmlTextWriter)

Zeigt das AdRotator-Steuerelement auf dem Client an.

RenderBeginTag(HtmlTextWriter)

Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt.

(Geerbt von Control)
RenderContents(HtmlTextWriter)

Rendert den Inhalt des Steuerelements im angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.

(Geerbt von Control)
RenderEndTag(HtmlTextWriter)

Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

(Geerbt von Control)
SaveViewState()

Speichert jeden Zustand, der nach dem Aufrufen der TrackViewState()-Methode geändert wurde.

(Geerbt von WebControl)
SaveViewState()

Speichert alle Änderungen am Ansichtszustand, die seit dem Zeitpunkt des Zurücksendens der Seite an den Server aufgetreten sind.

(Geerbt von DataBoundControl)
SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

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

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Bewirkt, dass das Steuerelement Änderungen an seinem Ansichtszustand in der ViewState-Eigenschaft des Objekts nachverfolgt.

(Geerbt von WebControl)
TrackViewState()

Veranlasst die Überwachung von Änderungen am Ansichtszustand des Steuerelements, sodass die Änderungen im StateBag-Objekt des Steuerelements gespeichert werden können.

(Geerbt von DataBoundControl)
ValidateDataSource(Object)

Überprüft, ob es sich bei dem Objekt, an das ein datengebundenes Steuerelement gebunden wird, um ein Objekt handelt, mit dem es arbeiten kann.

(Geerbt von DataBoundControl)

Ereignisse

AdCreated

Tritt nach dem Erstellen des Steuerelements einmal pro Schleife zum Server ein, jedoch vor dem Rendern der Seite.

CallingDataMethods

Tritt auf, wenn Datenmethoden aufgerufen werden.

(Geerbt von DataBoundControl)
CreatingModelDataSource

Tritt ein, wenn das ModelDataSource-Objekt erstellt wird.

(Geerbt von DataBoundControl)
DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.

(Geerbt von Control)
DataBound

Tritt ein, nachdem das Serversteuerelement an eine Datenquelle gebunden wurde.

(Geerbt von BaseDataBoundControl)
Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.

(Geerbt von Control)
Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.

(Geerbt von Control)
Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.

(Geerbt von Control)
PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.

(Geerbt von Control)
Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String)

Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.

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

Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest.

(Geerbt von WebControl)
IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).

(Geerbt von Control)

Erweiterungsmethoden

EnablePersistedSelection(BaseDataBoundControl)
Veraltet.

Ermöglicht das Beibehalten der Auswahl in Datensteuerelementen, die Auswahl und Paginierung unterstützen.

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.

Gilt für:

Weitere Informationen