AdRotator Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geeft een advertentiebanner weer op een webpagina.
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
- Overname
- Overname
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u het AdRotator besturingselement gebruikt om een advertentiebanner weer te geven op een webpagina.
<%@ 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>
In het volgende codevoorbeeld ziet u de bestandsindeling voor een XML-bestand met advertentiegegevens voor het vorige voorbeeld. Zie het lid voor meer informatie over de AdvertisementFile bestandsindeling.
<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>
Opmerkingen
In dit onderwerp:
Introductie
Gebruik het AdRotator besturingselement om een willekeurig geselecteerde advertentiebanner weer te geven op de webpagina. De weergegeven advertentie wordt gewijzigd wanneer de pagina wordt vernieuwd.
Advertentiegegevens worden opgeslagen in een afzonderlijk XML-bestand. Met het XML-bestand kunt u een lijst met advertenties en de bijbehorende kenmerken bijhouden. Kenmerken omvatten het pad naar een afbeelding die moet worden weergegeven, de URL waarnaar moet worden gekoppeld wanneer op het besturingselement wordt geklikt, de alternatieve tekst die moet worden weergegeven wanneer de afbeelding niet beschikbaar is, een trefwoord en de frequentie van de advertentie. Informatie in dit bestand wordt niet gevalideerd door het AdRotator besturingselement. Als u wilt voorkomen dat advertenties schadelijke scripts uitvoeren, moet u altijd de gegevens controleren voordat ze worden vrijgegeven of advertentiegegevens alleen accepteren uit vertrouwde bronnen.
Ga op een of meer van de volgende manieren te werk om uw advertentiebestand te beveiligen tegen onbevoegde internettoegang:
- Sla deze op in de App_Data map, die is geconfigureerd om internettoegang voor bestanden van elk type te weigeren.
- Wijzig de naam van het bestand met een extensie die niet .xmlen wijs de extensie toe aan de
HttpForbiddenHandlerextensie in Web.config. Zie dehttpHandlerssectie in uw Machine.config-bestand voor meer informatie.
Als alternatief voor een XML-bestand als bron van gegevens, is het mogelijk om advertentie-informatie te verstrekken via een callback-gebeurtenis. Deze gebeurtenis kan ook worden gebruikt in combinatie met het XML-bestand om het gedrag van het AdRotator besturingselement uit te breiden, zoals omleiden naar een andere pagina. Zie de AdvertisementFile eigenschap voor meer informatie over de bestandsindeling.
Note
Wanneer paginacache is ingeschakeld, wordt een AdRotator besturingselement niet in de cache opgeslagen. Er wordt een nieuwe advertentie geselecteerd wanneer de webpagina wordt vernieuwd. Er is echter geen nieuwe advertentie geselecteerd als u een gebeurtenis-handler voor de AdCreated gebeurtenis opgeeft.
XML-advertentiebestandsindeling
Het AdRotator besturingselement maakt gebruik van een afzonderlijk XML-advertentiebestand om de advertentiegegevens op te slaan, zoals de locatie van de afbeelding die moet worden weergegeven en de URL van de pagina waarnaar u een koppeling wilt maken. De AdvertisementFile eigenschap van het AdRotator besturingselement geeft het pad naar dit bestand op.
Bij het maken van het advertentiebestand markeren het openen en sluiten <Advertisements> van tags respectievelijk het begin en einde van het bestand. Elke advertentie wordt gescheiden door het openen en sluiten <Ad> van tags. Alle advertenties zijn genest tussen de openings- en sluitingstags <Advertisements> . Als het bestand meerdere <Advertisements> tags bevat, wordt alleen de eerste set <Advertisements> tags in het bestand geparseerd door het AdRotator besturingselement. Alle andere <Advertisements> tags worden genegeerd.
De gegevenselementen voor elke advertentie zijn genest tussen de openings- en slottags <Ad> . Hoewel bepaalde gegevenselementen vooraf zijn gedefinieerd (zoals ImageUrl en NavigateUrl), kunt u aangepaste elementen tussen de <Ad> tags plaatsen. Deze elementen worden gelezen door het AdRotator besturingselement wanneer het bestand wordt geparseerd. De informatie wordt vervolgens doorgegeven aan de AdCreated gebeurtenis in de AdProperties woordenlijsteigenschap.
De volgende tabel bevat de gegevenselementen die vooraf zijn gedefinieerd voor het XML-advertentiebestand.
| Element | Beschrijving |
|---|---|
ImageUrl |
De absolute of relatieve URL naar een afbeeldingsbestand (optioneel). |
NavigateUrl |
De URL van een pagina waarnaar moet worden gekoppeld als de gebruiker op de advertentie klikt (optioneel).
Opmerking: Als dit element niet is ingesteld, wordt de HRef eigenschap niet weergegeven op de ankertag. |
Height |
De hoogte van de afbeelding, in pixels (optioneel). |
Width |
De breedte van de afbeelding, in pixels (optioneel). |
AlternateText |
De tekst wordt weergegeven in plaats van de afbeelding wanneer de afbeelding die is opgegeven door de ImageUrl eigenschap niet beschikbaar is (optioneel). In sommige browsers wordt deze tekst ook weergegeven als een ToolTip voor de advertentie. |
Keyword |
Een categorie voor de advertentie (bijvoorbeeld 'computers') waarop u kunt filteren (optioneel). |
Impressions |
Een getal dat het belang van de advertentie aangeeft in het draaischema ten opzichte van de andere advertenties in het bestand (optioneel). Hoe groter het getal, hoe vaker de advertentie wordt weergegeven. Het totaal van alle <Impressions> waarden in het XML-bestand mag niet groter zijn dan 2.047.999.999. Als dit het geval is, genereert het AdRotator besturingselement een runtime-uitzondering. |
In het volgende voorbeeld ziet u de indeling voor het XML-advertentiebestand.
<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>
Declaratieve syntaxis
<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"
/>
Constructors
| Name | Description |
|---|---|
| AdRotator() |
Initialiseert een nieuw exemplaar van de AdRotator klasse. |
Eigenschappen
| Name | Description |
|---|---|
| AccessKey |
Hiermee haalt u de toegangssleutel op waarmee u snel naar het webserverbeheer kunt navigeren. (Overgenomen van WebControl) |
| Adapter |
Hiermee haalt u de browserspecifieke adapter voor het besturingselement op. (Overgenomen van Control) |
| AdvertisementFile |
Hiermee wordt het pad opgehaald of ingesteld op een XML-bestand dat advertentiegegevens bevat. |
| AlternateTextField |
Hiermee haalt u een aangepast gegevensveld op dat moet worden gebruikt in plaats van het |
| AppRelativeTemplateSourceDirectory |
Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat. (Overgenomen van Control) |
| Attributes |
Hiermee haalt u de verzameling willekeurige kenmerken (alleen voor rendering) op die niet overeenkomen met eigenschappen in het besturingselement. (Overgenomen van WebControl) |
| BackColor |
Hiermee haalt u de achtergrondkleur van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| BindingContainer |
Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat. (Overgenomen van Control) |
| BorderColor |
Hiermee haalt u de randkleur van het web besturingselement op of stelt u deze in. (Overgenomen van WebControl) |
| BorderStyle |
Hiermee haalt u de randstijl van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| BorderWidth |
Hiermee haalt u de randbreedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| ChildControlsCreated |
Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt. (Overgenomen van Control) |
| ClientID |
Hiermee haalt u de besturingselement-id op voor HTML-markeringen die worden gegenereerd door ASP.NET. (Overgenomen van Control) |
| ClientIDMode |
Hiermee wordt het algoritme opgehaald of ingesteld dat wordt gebruikt om de waarde van de ClientID eigenschap te genereren. (Overgenomen van Control) |
| ClientIDSeparator |
Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt. (Overgenomen van Control) |
| Context |
Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag. (Overgenomen van Control) |
| Controls |
Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie. (Overgenomen van Control) |
| ControlStyle |
Hiermee haalt u de stijl van het besturingselement webserver op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| ControlStyleCreated |
Hiermee wordt een waarde opgehaald die aangeeft of er een Style object is gemaakt voor de ControlStyle eigenschap. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| CssClass |
Hiermee wordt de CSS-klasse (Cascading Style Sheet) opgehaald of ingesteld die wordt weergegeven door het webserverbeheer op de client. (Overgenomen van WebControl) |
| DataItemContainer |
Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd. (Overgenomen van Control) |
| DataKeysContainer |
Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd. (Overgenomen van Control) |
| DataMember |
Hiermee wordt de naam van de lijst met gegevens opgehaald of ingesteld waaraan het besturingselement voor gegevens is gebonden, in gevallen waarin de gegevensbron meer dan één afzonderlijke lijst met gegevensitems bevat. (Overgenomen van DataBoundControl) |
| DataSource |
Hiermee haalt u het object op waaruit het gegevensgebonden besturingselement de lijst met gegevensitems ophaalt. (Overgenomen van BaseDataBoundControl) |
| DataSourceID |
Hiermee haalt u de id op van het besturingselement waaruit het gegevensgebonden besturingselement de lijst met gegevensitems ophaalt. (Overgenomen van DataBoundControl) |
| DataSourceObject |
Hiermee haalt u een object op dat de IDataSource interface implementeert, die toegang biedt tot de gegevensinhoud van het object. (Overgenomen van DataBoundControl) |
| DesignMode |
Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak. (Overgenomen van Control) |
| Enabled |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement webserver is ingeschakeld. (Overgenomen van WebControl) |
| EnableTheming |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of thema's van toepassing zijn op dit besturingselement. (Overgenomen van WebControl) |
| EnableViewState |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client. (Overgenomen van Control) |
| Events |
Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen. (Overgenomen van Control) |
| Font |
Hiermee haalt u de lettertype-eigenschappen op die zijn gekoppeld aan het besturingselement voor de advertentiebanner. |
| ForeColor |
Hiermee haalt u de voorgrondkleur (meestal de kleur van de tekst) van het webserverbesturingselement op of stelt u deze in. (Overgenomen van WebControl) |
| HasAttributes |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement kenmerken heeft ingesteld. (Overgenomen van WebControl) |
| HasChildViewState |
Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben. (Overgenomen van Control) |
| Height |
Hiermee haalt u de hoogte van het webserverbeheer op of stelt u deze in. (Overgenomen van WebControl) |
| ID |
Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen. (Overgenomen van Control) |
| IdSeparator |
Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden. (Overgenomen van Control) |
| ImageUrlField |
Hiermee haalt u een aangepast gegevensveld op dat moet worden gebruikt in plaats van het |
| Initialized |
Hiermee wordt een waarde opgehaald die aangeeft of het gegevensgebonden besturingselement is geïnitialiseerd. (Overgenomen van BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Hiermee wordt een waarde opgehaald die aangeeft of de DataSourceID eigenschap is ingesteld. (Overgenomen van BaseDataBoundControl) |
| IsChildControlStateCleared |
Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben. (Overgenomen van Control) |
| IsDataBindingAutomatic |
Hiermee wordt een waarde opgehaald die aangeeft of gegevensbinding automatisch is. (Overgenomen van BaseDataBoundControl) |
| IsEnabled |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement is ingeschakeld. (Overgenomen van WebControl) |
| IsTrackingViewState |
Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus. (Overgenomen van Control) |
| IsUsingModelBinders |
Hiermee wordt een waarde opgehaald die aangeeft of modelbinding wordt gebruikt. (Overgenomen van DataBoundControl) |
| IsViewStateEnabled |
Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement. (Overgenomen van Control) |
| ItemType |
Hiermee wordt de naam van het gegevensitemtype opgehaald of ingesteld voor sterk getypte gegevensbinding. (Overgenomen van DataBoundControl) |
| KeywordFilter |
Hiermee wordt een categoriewoord opgehaald of ingesteld om te filteren op specifieke typen advertenties in het XML-advertentiebestand. |
| LoadViewStateByID |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index. (Overgenomen van Control) |
| NamingContainer |
Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde. (Overgenomen van Control) |
| NavigateUrlField |
Hiermee haalt u een aangepast gegevensveld op dat moet worden gebruikt in plaats van het |
| Page |
Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat. (Overgenomen van Control) |
| Parent |
Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie. (Overgenomen van Control) |
| RenderingCompatibility |
Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met. (Overgenomen van Control) |
| RequiresDataBinding |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de DataBind() methode moet worden aangeroepen. (Overgenomen van BaseDataBoundControl) |
| SelectArguments |
Hiermee haalt u een DataSourceSelectArguments object op dat door het gegevensgebonden besturingselement wordt gebruikt bij het ophalen van gegevens uit een besturingselement voor gegevensbronnen. (Overgenomen van DataBoundControl) |
| SelectMethod |
De naam van de methode die moet worden aangeroepen om gegevens te lezen. (Overgenomen van DataBoundControl) |
| Site |
Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven. (Overgenomen van Control) |
| SkinID |
Hiermee wordt de huid op de controle toegepast of ingesteld. (Overgenomen van WebControl) |
| Style |
Hiermee haalt u een verzameling tekstkenmerken op die worden weergegeven als een stijlkenmerk op de buitenste tag van het besturingselement webserver. (Overgenomen van WebControl) |
| SupportsDisabledAttribute |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement het |
| TabIndex |
Hiermee haalt u de tabindex van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| TagKey |
Hiermee haalt u de HTML-tag voor het AdRotator besturingselement op. |
| TagKey |
Hiermee haalt u de HtmlTextWriterTag waarde op die overeenkomt met dit besturingselement van de webserver. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| TagName |
Hiermee haalt u de naam van het besturingselementlabel op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| Target |
Hiermee wordt de naam van het browservenster of frame opgehaald of ingesteld waarmee de inhoud van de webpagina wordt weergegeven die is gekoppeld wanneer op het AdRotator besturingselement wordt geklikt. |
| TemplateControl |
Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in. (Overgenomen van Control) |
| TemplateSourceDirectory |
Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat. (Overgenomen van Control) |
| ToolTip |
Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven wanneer de muisaanwijzer boven het besturingselement webserver beweegt. (Overgenomen van WebControl) |
| UniqueID |
Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het AdRotator besturingselement op. |
| UniqueID |
Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op. (Overgenomen van Control) |
| ValidateRequestMode |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden. (Overgenomen van Control) |
| ViewState |
Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Control) |
| ViewStateIgnoresCase |
Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is. (Overgenomen van Control) |
| ViewStateMode |
Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in. (Overgenomen van Control) |
| Visible |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een serverbesturing wordt weergegeven als gebruikersinterface op de pagina. (Overgenomen van Control) |
| Width |
Hiermee haalt u de breedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
Methoden
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Hiermee worden HTML-kenmerken en -stijlen toegevoegd die moeten worden weergegeven aan de opgegeven HtmlTextWriterTag. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| AddedControl(Control, Int32) |
Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object. (Overgenomen van Control) |
| AddParsedSubObject(Object) |
Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement. (Overgenomen van Control) |
| ApplyStyle(Style) |
Kopieert eventuele niet-lege elementen van de opgegeven stijl naar het web besturingselement, en overschrijft eventuele bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| ApplyStyleSheetSkin(Page) |
De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement. (Overgenomen van Control) |
| BeginRenderTracing(TextWriter, Object) |
Begint met het traceren van ontwerptijd van renderinggegevens. (Overgenomen van Control) |
| BuildProfileTree(String, Boolean) |
Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina. (Overgenomen van Control) |
| ClearCachedClientID() |
Hiermee stelt u de waarde in de cache in ClientID op |
| ClearChildControlState() |
Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| ClearChildState() |
Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| ClearChildViewState() |
Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| ClearEffectiveClientIDMode() |
Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit. (Overgenomen van Control) |
| ConfirmInitState() |
Hiermee stelt u de geïnitialiseerde status van het gegevensgebonden besturingselement in. (Overgenomen van BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Kopieert de eigenschappen die niet zijn ingekapseld door het Style object van het opgegeven webserverbesturingselement naar het webserverbesturingselement waaruit deze methode wordt aangeroepen. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| CreateChildControls() |
Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven. (Overgenomen van Control) |
| CreateControlCollection() |
Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement. |
| CreateControlCollection() |
Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement. (Overgenomen van Control) |
| CreateControlStyle() |
Hiermee maakt u het stijlobject dat intern door de WebControl klasse wordt gebruikt om alle stijlgerelateerde eigenschappen te implementeren. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| CreateDataSourceSelectArguments() |
Hiermee maakt u een standaardobject DataSourceSelectArguments dat wordt gebruikt door het besturingselement voor gegevens als er geen argumenten zijn opgegeven. (Overgenomen van DataBoundControl) |
| DataBind() |
Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van Control) |
| DataBind() |
Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van BaseDataBoundControl) |
| DataBind(Boolean) |
Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren. (Overgenomen van Control) |
| DataBindChildren() |
Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| Dispose() |
Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven. (Overgenomen van Control) |
| EndRenderTracing(TextWriter, Object) |
Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd. (Overgenomen van Control) |
| EnsureChildControls() |
Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt. (Overgenomen van Control) |
| EnsureDataBound() |
Roept de DataBind() methode aan als de DataSourceID eigenschap is ingesteld en het gegevensgebonden besturingselement is gemarkeerd om binding te vereisen. (Overgenomen van BaseDataBoundControl) |
| EnsureID() |
Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen. (Overgenomen van Control) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| FindControl(String, Int32) |
Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven |
| FindControl(String) |
Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven |
| Focus() |
Hiermee stelt u de invoerfocus in op een besturingselement. (Overgenomen van Control) |
| GetData() |
Hiermee haalt u een DataSourceView object op dat door het gegevensgebonden besturingselement wordt gebruikt om gegevensbewerkingen uit te voeren. (Overgenomen van DataBoundControl) |
| GetDataSource() |
Haalt de IDataSource interface op waaraan het besturingselement voor gegevens is gekoppeld, indien van toepassing. (Overgenomen van DataBoundControl) |
| GetDesignModeState() |
Hiermee haalt u ontwerptijdgegevens op voor een besturingselement. (Overgenomen van Control) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetRouteUrl(Object) |
Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control) |
| GetRouteUrl(RouteValueDictionary) |
Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control) |
| GetRouteUrl(String, Object) |
Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| GetUniqueIDRelativeTo(Control) |
Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement. (Overgenomen van Control) |
| HasControls() |
Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. (Overgenomen van Control) |
| HasEvents() |
Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen. (Overgenomen van Control) |
| IsLiteralContent() |
Bepaalt of het serverbeheer alleen letterlijke inhoud bevat. (Overgenomen van Control) |
| LoadControlState(Object) |
Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen. (Overgenomen van Control) |
| LoadViewState(Object) |
Hiermee herstelt u informatie over de weergavestatus van een vorige aanvraag die is opgeslagen met de SaveViewState() methode. (Overgenomen van WebControl) |
| LoadViewState(Object) |
Hiermee herstelt u informatie over de weergavestatus van een vorige paginaaanvraag die is opgeslagen door de SaveViewState() methode. (Overgenomen van DataBoundControl) |
| MapPathSecure(String) |
Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen. (Overgenomen van Control) |
| MarkAsDataBound() |
Hiermee stelt u de status van het besturingselement in de weergavestatus in als gekoppeld aan gegevens. (Overgenomen van DataBoundControl) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MergeStyle(Style) |
Kopieert niet-lege elementen van de opgegeven stijl naar het webbesturing, maar overschrijft geen bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| OnAdCreated(AdCreatedEventArgs) |
Hiermee wordt de AdCreated gebeurtenis voor het AdRotator besturingselement gegenereerd. |
| OnBubbleEvent(Object, EventArgs) |
Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina. (Overgenomen van Control) |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Hiermee wordt de CreatingModelDataSource gebeurtenis gegenereerd. (Overgenomen van DataBoundControl) |
| OnDataBinding(EventArgs) |
Hiermee wordt de DataBinding gebeurtenis gegenereerd. (Overgenomen van Control) |
| OnDataBound(EventArgs) |
Hiermee wordt de DataBound gebeurtenis gegenereerd. (Overgenomen van BaseDataBoundControl) |
| OnDataPropertyChanged() |
Hiermee wordt het gegevensgebonden besturingselement opnieuw gekoppeld aan de gegevens nadat een van de eigenschappen van de basisgegevensbronidentificatie is gewijzigd. (Overgenomen van DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Hiermee wordt de DataSourceViewChanged gebeurtenis gegenereerd. (Overgenomen van DataBoundControl) |
| OnInit(EventArgs) |
Hiermee wordt de Init gebeurtenis gegenereerd. |
| OnInit(EventArgs) |
Hiermee wordt de Init gebeurtenis gegenereerd. (Overgenomen van Control) |
| OnLoad(EventArgs) |
Hiermee wordt de Load gebeurtenis gegenereerd. (Overgenomen van Control) |
| OnLoad(EventArgs) |
Hiermee wordt de Load gebeurtenis verwerkt. (Overgenomen van DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Hiermee stelt u de geïnitialiseerde status van het gegevensgebonden besturingselement in voordat het besturingselement wordt geladen. (Overgenomen van DataBoundControl) |
| OnPreRender(EventArgs) |
Hiermee haalt u de advertentie-informatie voor rendering op door de bestandsgegevens op te zoeken of de gebruikersevenement aan te roepen. |
| OnUnload(EventArgs) |
Hiermee wordt de Unload gebeurtenis gegenereerd. (Overgenomen van Control) |
| OpenFile(String) |
Hiermee wordt een Stream bestand gelezen. (Overgenomen van Control) |
| PerformDataBinding(IEnumerable) |
Verbindt de opgegeven gegevensbron met het AdRotator besturingselement. |
| PerformSelect() |
Haalt de advertentiegegevens op uit de bijbehorende gegevensbron. |
| RaiseBubbleEvent(Object, EventArgs) |
Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement. (Overgenomen van Control) |
| RemovedControl(Control) |
Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object. (Overgenomen van Control) |
| Render(HtmlTextWriter) |
Geeft het AdRotator besturingselement op de client weer. |
| RenderBeginTag(HtmlTextWriter) |
Geeft de HTML-openingstag van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| RenderChildren(HtmlTextWriter) |
Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control) |
| RenderContents(HtmlTextWriter) |
Geeft de inhoud van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object. (Overgenomen van Control) |
| RenderControl(HtmlTextWriter) |
Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld. (Overgenomen van Control) |
| RenderEndTag(HtmlTextWriter) |
Geeft de HTML-slottag van het besturingselement weer in de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| ResolveAdapter() |
Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement. (Overgenomen van Control) |
| ResolveClientUrl(String) |
Hiermee haalt u een URL op die door de browser kan worden gebruikt. (Overgenomen van Control) |
| ResolveUrl(String) |
Converteert een URL naar een URL die bruikbaar is voor de aanvragende client. (Overgenomen van Control) |
| SaveControlState() |
Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control) |
| SaveViewState() |
Hiermee wordt een status opgeslagen die is gewijzigd nadat de TrackViewState() methode is aangeroepen. (Overgenomen van WebControl) |
| SaveViewState() |
Slaat eventuele wijzigingen in de weergavestatus op die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van DataBoundControl) |
| SetDesignModeState(IDictionary) |
Hiermee stelt u ontwerptijdgegevens in voor een besturingselement. (Overgenomen van Control) |
| SetRenderMethodDelegate(RenderMethod) |
Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement. (Overgenomen van Control) |
| SetTraceData(Object, Object, Object) |
Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control) |
| SetTraceData(Object, Object) |
Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| TrackViewState() |
Hiermee zorgt u ervoor dat het besturingselement wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het object. (Overgenomen van WebControl) |
| TrackViewState() |
Zorgt ervoor dat wijzigingen in de weergavestatus van het besturingselement worden bijgehouden, zodat ze kunnen worden opgeslagen in het object van StateBag het besturingselement. (Overgenomen van DataBoundControl) |
| ValidateDataSource(Object) |
Controleert of het object een gegevensgebonden besturingselement verbindt met één object waarmee het kan werken. (Overgenomen van DataBoundControl) |
gebeurtenis
| Name | Description |
|---|---|
| AdCreated |
Vindt eenmaal per retour naar de server plaats na het maken van het besturingselement, maar voordat de pagina wordt weergegeven. |
| CallingDataMethods |
Treedt op wanneer gegevensmethoden worden aangeroepen. (Overgenomen van DataBoundControl) |
| CreatingModelDataSource |
Treedt op wanneer het ModelDataSource object wordt gemaakt. (Overgenomen van DataBoundControl) |
| DataBinding |
Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron. (Overgenomen van Control) |
| DataBound |
Vindt plaats nadat het serverbeheer verbinding heeft gemaakt met een gegevensbron. (Overgenomen van BaseDataBoundControl) |
| Disposed |
Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd. (Overgenomen van Control) |
| Init |
Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus. (Overgenomen van Control) |
| Load |
Treedt op wanneer het serverbeheer in het Page object wordt geladen. (Overgenomen van Control) |
| PreRender |
Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven. (Overgenomen van Control) |
| Unload |
Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd. (Overgenomen van Control) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Hiermee haalt u een kenmerk van het webbeheer op met de opgegeven naam. (Overgenomen van WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Hiermee stelt u een kenmerk van het webbeheer in op de opgegeven naam en waarde. (Overgenomen van WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Zie voor een beschrijving van dit lid ControlBuilder. (Overgenomen van Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Zie voor een beschrijving van dit lid GetDesignModeState(). (Overgenomen van Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary). (Overgenomen van Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Zie voor een beschrijving van dit lid SetOwnerControl(Control). (Overgenomen van Control) |
| IControlDesignerAccessor.UserData |
Zie voor een beschrijving van dit lid UserData. (Overgenomen van Control) |
| IDataBindingsAccessor.DataBindings |
Zie voor een beschrijving van dit lid DataBindings. (Overgenomen van Control) |
| IDataBindingsAccessor.HasDataBindings |
Zie voor een beschrijving van dit lid HasDataBindings. (Overgenomen van Control) |
| IExpressionsAccessor.Expressions |
Zie voor een beschrijving van dit lid Expressions. (Overgenomen van Control) |
| IExpressionsAccessor.HasExpressions |
Zie voor een beschrijving van dit lid HasExpressions. (Overgenomen van Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Zie voor een beschrijving van dit lid AddParsedSubObject(Object). (Overgenomen van Control) |
Extensiemethoden
| Name | Description |
|---|---|
| EnablePersistedSelection(BaseDataBoundControl) |
Verouderd.
Hiermee kunt u selectie behouden in gegevensbesturingselementen die ondersteuning bieden voor selectie en paging. |
| FindDataSourceControl(Control) |
Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement. |
| FindFieldTemplate(Control, String) |
Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement. |
| FindMetaTable(Control) |
Retourneert het metatable-object voor het bevattende gegevensbeheer. |