AdRotator Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wyświetla baner anonsowy na stronie sieci Web.

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

Dziedziczenie: Object

Control

WebControl
AdRotator

Dziedziczenie: Object

Control

WebControl

BaseDataBoundControl

DataBoundControl
AdRotator

Przykłady

Poniższy przykład kodu pokazuje, jak używać kontrolki AdRotator do wyświetlania baneru anonsowego na stronie sieci Web.

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

Poniższy przykład kodu przedstawia format pliku XML, który zawiera informacje o anonsie dla poprzedniego przykładu. Aby uzyskać więcej informacji na temat formatu pliku, zobacz AdvertisementFile element członkowski.

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

Uwagi

W tym temacie:

Wprowadzenie
Format pliku anonsowania XML
Składnia deklaracyjna

Wprowadzenie

Użyj kontrolki, AdRotator aby wyświetlić losowo wybrany baner anonsowy na stronie sieci Web. Wyświetlana reklama zmienia się za każdym razem, gdy strona zostanie odświeżona.

Informacje o anonsie są przechowywane w osobnym pliku XML. Plik XML umożliwia utrzymanie listy anonsów i skojarzonych z nimi atrybutów. Atrybuty obejmują ścieżkę do obrazu do wyświetlenia, adres URL do linku po kliknięciu kontrolki, alternatywny tekst do wyświetlenia, gdy obraz jest niedostępny, słowo kluczowe i częstotliwość anonsu. Informacje w tym pliku nie są weryfikowane przez kontrolkę AdRotator . Aby zapobiec wykonywaniu złośliwych skryptów przez reklamy, należy zawsze sprawdzać dane przed ich wydaniem lub akceptować informacje reklamowe tylko z zaufanych źródeł.

Aby zabezpieczyć plik anonsowania przed nieautoryzowanym dostępem do Internetu, wykonaj co najmniej jedną z następujących czynności:

Zapisz go w katalogu App_Data, który jest skonfigurowany do odmowy dostępu do Internetu dla plików dowolnego typu.
Zmień nazwę pliku na rozszerzenie, które nie jest .xml, i zamapuj rozszerzenie na HttpForbiddenHandler w Web.config. Aby uzyskać więcej informacji, zobacz sekcję httpHandlers w pliku Machine.config.

Alternatywą dla pliku XML jako źródła danych jest udostępnienie informacji anonsowych za pośrednictwem zdarzenia wywołania zwrotnego. To zdarzenie może być również używane w połączeniu z plikiem XML w celu rozszerzenia zachowania AdRotator kontrolki, na przykład przekierowania do innej strony. AdvertisementFile Aby uzyskać dodatkowe informacje na temat formatu pliku, zobacz właściwość .

Uwaga

Gdy buforowanie stron jest włączone, kontrolka AdRotator nie jest buforowana. Za każdym razem, gdy strona sieci Web zostanie odświeżona, zostanie wybrana nowa anons. Nie wybrano jednak nowej anonsu, jeśli podasz procedurę obsługi zdarzeń AdCreated dla zdarzenia.

Format pliku anonsowania XML

Kontrolka AdRotator używa oddzielnego pliku anonsowania XML do przechowywania informacji o anonsie, takich jak lokalizacja obrazu do wyświetlenia i adres URL strony do połączenia. Właściwość AdvertisementFile kontrolki AdRotator określa ścieżkę do tego pliku.

Podczas tworzenia pliku anonsowania, otwieranie i zamykanie <Advertisements> tagów oznacza odpowiednio początek i koniec pliku. Otwieranie i zamykanie <Ad> tagów rozdziela poszczególne anonse. Wszystkie anonse są zagnieżdżone między tagami otwierania i zamykania <Advertisements> . Jeśli plik zawiera wiele <Advertisements> tagów, tylko pierwszy zestaw tagów <Advertisements> w pliku zostanie przeanalizowany przez kontrolkę AdRotator . Wszystkie inne <Advertisements> tagi zostaną zignorowane.

Elementy danych dla każdej reklamy są zagnieżdżone między tagami otwierania i zamykania <Ad> . Chociaż niektóre elementy danych są wstępnie zdefiniowane (takie jak ImageUrl i NavigateUrl), można umieszczać elementy niestandardowe między <Ad> tagami. Te elementy będą odczytywane przez kontrolkę AdRotator podczas analizowania pliku. Informacje są następnie przekazywane do AdCreated zdarzenia we właściwości słownika AdProperties .

W poniższej tabeli wymieniono elementy danych, które są wstępnie zdefiniowane dla pliku anonsu XML.

Element	Opis
`ImageUrl`	Bezwzględny lub względny adres URL pliku obrazu (opcjonalnie).
`NavigateUrl`	Adres URL strony do linku, jeśli użytkownik kliknie reklamę (opcjonalnie). Uwaga: Jeśli ten element nie jest ustawiony, `HRef` właściwość nie jest renderowana w tagu kotwicy.
`Height`	Wysokość obrazu w pikselach (opcjonalnie).
`Width`	Szerokość obrazu w pikselach (opcjonalnie).
`AlternateText`	Tekst wyświetlany zamiast obrazu, gdy obraz określony przez ImageUrl właściwość jest niedostępny (opcjonalnie). W niektórych przeglądarkach ten tekst jest również wyświetlany jako anons `ToolTip` .
`Keyword`	Kategoria anonsu (na przykład "komputery"), którą można filtrować według (opcjonalnie).
`Impressions`	Liczba wskazująca znaczenie reklamy w harmonogramie rotacji względem innych reklam w pliku (opcjonalnie). Większa liczba, tym częściej jest wyświetlana reklama. Suma wszystkich `<Impressions>` wartości w pliku XML nie może przekraczać 2047 999 999 999. Jeśli tak, kontrolka AdRotator zgłasza wyjątek czasu wykonywania.

Poniższy przykład przedstawia format pliku anonsowania XML.

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

Składnia deklaracyjna

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

Konstruktory

AdRotator()

Inicjuje nowe wystąpienie klasy AdRotator.

Właściwości

AccessKey	Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web. (Odziedziczone po WebControl)
Adapter	Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control)
AdvertisementFile	Pobiera lub ustawia ścieżkę do pliku XML zawierającego informacje o anonsowaniu.
AlternateTextField	Pobiera lub ustawia niestandardowe pole danych, które ma być używane zamiast atrybutu `AlternateText` dla anonsu.
AppRelativeTemplateSourceDirectory	Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control)
Attributes	Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki. (Odziedziczone po WebControl)
BackColor	Pobiera lub ustawia kolor tła kontrolki serwera sieci Web. (Odziedziczone po WebControl)
BindingContainer	Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki. (Odziedziczone po Control)
BorderColor	Pobiera lub ustawia kolor obramowania kontrolki Sieci Web. (Odziedziczone po WebControl)
BorderStyle	Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl)
BorderWidth	Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl)
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona. (Odziedziczone po Control)
ClientID	Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control)
ClientIDMode	Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości. (Odziedziczone po Control)
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control)
Context	HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control)
Controls	ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po Control)
ControlStyle	Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
ControlStyleCreated	Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości . Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
CssClass	Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie. (Odziedziczone po WebControl)
DataItemContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control)
DataKeysContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control)
DataMember	Pobiera lub ustawia nazwę listy danych, z którymi wiąże się kontrolka związana z danymi, w przypadkach, gdy źródło danych zawiera więcej niż jedną odrębną listę elementów danych. (Odziedziczone po DataBoundControl)
DataSource	Pobiera lub ustawia obiekt, z którego kontrolka powiązana z danymi pobiera listę elementów danych. (Odziedziczone po BaseDataBoundControl)
DataSourceID	Pobiera lub ustawia identyfikator kontrolki, z której kontrolka powiązana z danymi pobiera listę elementów danych. (Odziedziczone po DataBoundControl)
DataSourceObject	Pobiera obiekt, który implementuje IDataSource interfejs, który zapewnia dostęp do zawartości danych obiektu. (Odziedziczone po DataBoundControl)
DesignMode	Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control)
Enabled	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona. (Odziedziczone po WebControl)
EnableTheming	Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po WebControl)
EnableViewState	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego. (Odziedziczone po Control)
Events	Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control)
Font	Pobiera właściwości czcionki skojarzone z kontrolką baneru anonsu.
ForeColor	Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web. (Odziedziczone po WebControl)
HasAttributes	Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty. (Odziedziczone po WebControl)
HasChildViewState	Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku. (Odziedziczone po Control)
Height	Pobiera lub ustawia wysokość kontrolki serwera sieci Web. (Odziedziczone po WebControl)
ID	Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control)
IdSeparator	Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control)
ImageUrlField	Pobiera lub ustawia niestandardowe pole danych, które ma być używane zamiast atrybutu `ImageUrl` dla anonsu.
Initialized	Pobiera wartość wskazującą, czy kontrolka powiązana z danymi została zainicjowana. (Odziedziczone po BaseDataBoundControl)
IsBoundUsingDataSourceID	Pobiera wartość wskazującą, czy właściwość jest ustawiona DataSourceID . (Odziedziczone po BaseDataBoundControl)
IsChildControlStateCleared	Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control)
IsDataBindingAutomatic	Pobiera wartość wskazującą, czy powiązanie danych jest automatyczne. (Odziedziczone po BaseDataBoundControl)
IsEnabled	Pobiera wartość wskazującą, czy kontrolka jest włączona. (Odziedziczone po WebControl)
IsTrackingViewState	Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control)
IsUsingModelBinders	Pobiera wartość wskazującą, czy powiązanie modelu jest używane. (Odziedziczone po DataBoundControl)
IsViewStateEnabled	Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki. (Odziedziczone po Control)
ItemType	Pobiera lub ustawia nazwę typu elementu danych dla silnie typizowanego powiązania danych. (Odziedziczone po DataBoundControl)
KeywordFilter	Pobiera lub ustawia słowo kluczowe kategorii do filtrowania pod kątem określonych typów anonsów w pliku anonsowania XML.
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu. (Odziedziczone po Control)
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control)
NavigateUrlField	Pobiera lub ustawia niestandardowe pole danych, które ma być używane zamiast atrybutu `NavigateUrl` dla anonsu.
Page	Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control)
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony. (Odziedziczone po Control)
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control)
RequiresDataBinding	Pobiera lub ustawia wartość wskazującą, czy należy wywołać metodę DataBind() . (Odziedziczone po BaseDataBoundControl)
SelectArguments	Pobiera obiekt używany przez kontrolkę DataSourceSelectArguments związaną z danymi podczas pobierania danych z kontrolki źródła danych. (Odziedziczone po DataBoundControl)
SelectMethod	Nazwa metody do wywołania w celu odczytu danych. (Odziedziczone po DataBoundControl)
Site	Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control)
SkinID	Pobiera lub ustawia skórę do zastosowania do kontrolki. (Odziedziczone po WebControl)
Style	Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web. (Odziedziczone po WebControl)
SupportsDisabledAttribute	Pobiera wartość wskazującą, czy kontrolka powinna ustawić `disabled` atrybut renderowanego elementu HTML na wartość "disabled", gdy właściwość kontrolki IsEnabled to `false`. (Odziedziczone po WebControl)
SupportsDisabledAttribute	Pobiera wartość wskazującą, czy kontrolka powinna ustawić `disabled` atrybut renderowanego elementu HTML na wartość "disabled", gdy właściwość kontrolki IsEnabled ma wartość `false`. (Odziedziczone po BaseDataBoundControl)
TabIndex	Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web. (Odziedziczone po WebControl)
TagKey	Pobiera tag HTML dla kontrolki AdRotator .
TagKey	Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontroli serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl)
TagName	Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl)
Target	Pobiera lub ustawia nazwę okna przeglądarki lub ramki, która wyświetla zawartość strony sieci Web połączonej po kliknięciu AdRotator kontrolki.
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control)
TemplateSourceDirectory	Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control)
ToolTip	Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web. (Odziedziczone po WebControl)
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontrolki AdRotator .
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control)
ValidateRequestMode	Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control)
ViewState	Pobiera słownik informacji o stanie, który pozwala zapisać i przywrócić stan widoku kontroli serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control)
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt nie uwzględnia wielkości liter. (Odziedziczone po Control)
ViewStateMode	Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control)
Visible	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie. (Odziedziczone po Control)
Width	Pobiera lub ustawia szerokość kontrolki serwera sieci Web. (Odziedziczone po WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)	Dodaje atrybuty i style HTML, które należy renderować do określonego HtmlTextWriterTagelementu . Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
AddedControl(Control, Int32)	Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control)
AddParsedSubObject(Object)	Powiadamia kontrolkę serwera, że element , XML lub HTML, został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control)
ApplyStyle(Style)	Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
ApplyStyleSheetSkin(Page)	Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)	Rozpoczyna śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control)
BuildProfileTree(String, Boolean)	Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control)
ClearCachedClientID()	Ustawia wartość buforowanej ClientID na `null`. (Odziedziczone po Control)
ClearChildControlState()	Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildState()	Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildViewState()	Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearEffectiveClientIDMode()	ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inherit. (Odziedziczone po Control)
ConfirmInitState()	Ustawia zainicjowany stan kontrolki powiązanej z danymi. (Odziedziczone po BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z którego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
CreateChildControls()	Wywoływana przez platformę stron ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania. (Odziedziczone po Control)
CreateControlCollection()	Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literał i serwer) kontrolki serwera.
CreateControlCollection()	Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literału i serwera) kontrolki serwera. (Odziedziczone po Control)
CreateControlStyle()	Tworzy obiekt stylu używany wewnętrznie przez klasę WebControl do implementowania wszystkich właściwości pokrewnych stylu. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
CreateDataSourceSelectArguments()	Tworzy obiekt domyślny DataSourceSelectArguments używany przez kontrolkę związaną z danymi, jeśli nie określono żadnych argumentów. (Odziedziczone po DataBoundControl)
DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi kontrolkami podrzędnymi. (Odziedziczone po Control)
DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi. (Odziedziczone po BaseDataBoundControl)
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding . (Odziedziczone po Control)
DataBindChildren()	Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control)
Dispose()	Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)	Kończy śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control)
EnsureChildControls()	Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control)
EnsureDataBound()	Wywołuje metodę DataBind() , jeśli DataSourceID właściwość jest ustawiona, a kontrolka powiązana z danymi jest oznaczona w celu wymagania powiązania. (Odziedziczone po BaseDataBoundControl)
EnsureID()	Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego `id` parametru. (Odziedziczone po Control)
FindControl(String, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą `id` całkowitą określoną w parametrze `pathOffset` , co ułatwia wyszukiwanie. Nie należy zastąpić tej wersji FindControl metody. (Odziedziczone po Control)
Focus()	Ustawia fokus wejściowy na kontrolkę. (Odziedziczone po Control)
GetData()	Pobiera obiekt używany przez kontrolkę związaną DataSourceView z danymi do wykonywania operacji na danych. (Odziedziczone po DataBoundControl)
GetDataSource()	IDataSource Pobiera interfejs skojarzony z kontrolką związaną z danymi, jeśli istnieje. (Odziedziczone po DataBoundControl)
GetDesignModeState()	Pobiera dane w czasie projektowania dla kontrolki. (Odziedziczone po Control)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRouteUrl(Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(String, Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)	Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control)
HasControls()	Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control)
HasEvents()	Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control)
IsLiteralContent()	Określa, czy kontrolka serwera zawiera tylko zawartość literału. (Odziedziczone po Control)
LoadControlState(Object)	Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control)
LoadViewState(Object)	Przywraca informacje o stanie widoku z poprzedniego żądania, które zostało zapisane za pomocą SaveViewState() metody . (Odziedziczone po WebControl)
LoadViewState(Object)	Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez metodę SaveViewState() . (Odziedziczone po DataBoundControl)
MapPathSecure(String)	Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control)
MarkAsDataBound()	Ustawia stan kontrolki w stanie widoku jako pomyślnie powiązany z danymi. (Odziedziczone po DataBoundControl)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MergeStyle(Style)	Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl)
OnAdCreated(AdCreatedEventArgs)	AdCreated Zgłasza zdarzenie dla kontrolkiAdRotator.
OnBubbleEvent(Object, EventArgs)	Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)	CreatingModelDataSource Zgłasza zdarzenie. (Odziedziczone po DataBoundControl)
OnDataBinding(EventArgs)	DataBinding Zgłasza zdarzenie. (Odziedziczone po Control)
OnDataBound(EventArgs)	DataBound Zgłasza zdarzenie. (Odziedziczone po BaseDataBoundControl)
OnDataPropertyChanged()	Zmienia powiązanie kontrolki powiązanej z danymi po zmianie jednej z właściwości identyfikacji bazowego źródła danych. (Odziedziczone po DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)	DataSourceViewChanged Zgłasza zdarzenie. (Odziedziczone po DataBoundControl)
OnInit(EventArgs)	Init Zgłasza zdarzenie.
OnInit(EventArgs)	Init Zgłasza zdarzenie. (Odziedziczone po Control)
OnLoad(EventArgs)	Load Zgłasza zdarzenie. (Odziedziczone po Control)
OnLoad(EventArgs)	Load Obsługuje zdarzenie. (Odziedziczone po DataBoundControl)
OnPagePreLoad(Object, EventArgs)	Ustawia zainicjowany stan kontrolki powiązanej z danymi przed załadowaniem kontrolki. (Odziedziczone po DataBoundControl)
OnPreRender(EventArgs)	Pobiera informacje o anonsie do renderowania, wyszukując dane pliku lub wywołując zdarzenie użytkownika.
OnUnload(EventArgs)	Unload Zgłasza zdarzenie. (Odziedziczone po Control)
OpenFile(String)	Stream Pobiera element używany do odczytywania pliku. (Odziedziczone po Control)
PerformDataBinding(IEnumerable)	Tworzy powiązanie określonego źródła danych z kontrolką AdRotator .
PerformSelect()	Pobiera dane anonsu ze skojarzonego źródła danych.
RaiseBubbleEvent(Object, EventArgs)	Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control)
RemovedControl(Control)	Wywoływane po usunięciu kontrolki podrzędnej Controls z kolekcji Control obiektu. (Odziedziczone po Control)
Render(HtmlTextWriter)	Wyświetla kontrolkę AdRotator na kliencie.
RenderBeginTag(HtmlTextWriter)	Renderuje tag otwierający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl)
RenderChildren(HtmlTextWriter)	Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control)
RenderContents(HtmlTextWriter)	Renderuje zawartość kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl)
RenderControl(HtmlTextWriter)	Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu. (Odziedziczone po Control)
RenderEndTag(HtmlTextWriter)	Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl)
ResolveAdapter()	Pobiera kartę kontrolną odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control)
ResolveClientUrl(String)	Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control)
ResolveUrl(String)	Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control)
SaveControlState()	Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control)
SaveViewState()	Zapisuje dowolny stan, który został zmodyfikowany po TrackViewState() wywołaniu metody. (Odziedziczone po WebControl)
SaveViewState()	Zapisuje wszelkie zmiany stanu widoku, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataBoundControl)
SetDesignModeState(IDictionary)	Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)	Przypisuje delegata procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej. (Odziedziczone po Control)
SetTraceData(Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
SetTraceData(Object, Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	Powoduje, że kontrolka będzie śledzić zmiany stanu widoku, dzięki czemu mogą być przechowywane we właściwości obiektu ViewState . (Odziedziczone po WebControl)
TrackViewState()	Powoduje, że zmiany stanu widoku kontrolki mają być śledzone, aby można je było przechowywać w obiekcie kontrolki StateBag . (Odziedziczone po DataBoundControl)
ValidateDataSource(Object)	Sprawdza, czy obiekt, z którą jest powiązana kontrolka związana z danymi, jest tym, z którymi może pracować. (Odziedziczone po DataBoundControl)

Zdarzenia

AdCreated	Występuje raz na rundę na serwerze po utworzeniu kontrolki, ale przed renderowaniem strony.
CallingDataMethods	Występuje, gdy są wywoływane metody danych. (Odziedziczone po DataBoundControl)
CreatingModelDataSource	Występuje podczas ModelDataSource tworzenia obiektu. (Odziedziczone po DataBoundControl)
DataBinding	Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control)
DataBound	Występuje po powiązaniu kontrolki serwera ze źródłem danych. (Odziedziczone po BaseDataBoundControl)
Disposed	Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona ASP.NET. (Odziedziczone po Control)
Init	Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control)
Load	Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control)
PreRender	Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control)
Unload	Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control)

Jawne implementacje interfejsu

IAttributeAccessor.GetAttribute(String)	Pobiera atrybut kontrolki Sieci Web o określonej nazwie. (Odziedziczone po WebControl)
IAttributeAccessor.SetAttribute(String, String)	Ustawia atrybut kontrolki Sieci Web na określoną nazwę i wartość. (Odziedziczone po WebControl)
IControlBuilderAccessor.ControlBuilder	Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder. (Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()	Aby uzyskać opis tego członka, zobacz GetDesignModeState(). (Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Aby uzyskać opis tego członka, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Aby uzyskać opis tego członka, zobacz SetOwnerControl(Control). (Odziedziczone po Control)
IControlDesignerAccessor.UserData	Aby uzyskać opis tego członka, zobacz UserData. (Odziedziczone po Control)
IDataBindingsAccessor.DataBindings	Aby uzyskać opis tego członka, zobacz DataBindings. (Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings	Aby uzyskać opis tego członka, zobacz HasDataBindings. (Odziedziczone po Control)
IExpressionsAccessor.Expressions	Aby uzyskać opis tego członka, zobacz Expressions. (Odziedziczone po Control)
IExpressionsAccessor.HasExpressions	Aby uzyskać opis tego członka, zobacz HasExpressions. (Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)	Aby uzyskać opis tego członka, zobacz AddParsedSubObject(Object). (Odziedziczone po Control)

Metody rozszerzania

EnablePersistedSelection(BaseDataBoundControl)	Przestarzałe. Umożliwia utrwalone zaznaczenie w kontrolkach danych, które obsługują wybór i stronicowanie.
FindDataSourceControl(Control)	Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.
FindFieldTemplate(Control, String)	Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.
FindMetaTable(Control)	Zwraca obiekt metatable dla kontrolki zawierającej dane.

Dotyczy

Udostępnij za pośrednictwem