BaseValidator Klasa

Definicja

Służy jako abstrakcyjna klasa bazowa dla kontrolek weryfikacji.

public ref class BaseValidator abstract : System::Web::UI::WebControls::Label, System::Web::UI::IValidator
public abstract class BaseValidator : System.Web.UI.WebControls.Label, System.Web.UI.IValidator
type BaseValidator = class
    inherit Label
    interface IValidator
Public MustInherit Class BaseValidator
Inherits Label
Implements IValidator
Dziedziczenie
BaseValidator
Pochodne
Implementuje

Przykłady

W poniższym przykładzie kodu pokazano, jak używać wielu kontrolek weryfikacji w celu sprawdzenia, czy użytkownik wprowadza prawidłową wartość w kontrolce TextBox .

Ważne

W tym przykładzie znajduje się pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>
<%@ Page Language="VB" AutoEventWireup="False" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

Uwagi

Klasa BaseValidator zapewnia podstawową implementację wszystkich kontrolek weryfikacji. Kontrolki weryfikacji służą do weryfikowania danych wejściowych użytkownika w skojarzonej kontrolce wejściowej. Gdy użytkownik wprowadzi wartość, która zakończy się niepowodzeniem walidacji, kontrolka walidacji wyświetli komunikat o błędzie. Ponieważ kontrolka walidacji jest oddzielona od kontrolki wejściowej, można umieścić komunikat o błędzie w dowolnym miejscu na stronie względem kontrolki wejściowej. ASP.NET zawiera kilka kontrolek weryfikacji, które wykonują określone typy walidacji. W poniższej tabeli opisano te kontrolki.

Kontrola poprawności Opis
CompareValidator Weryfikuje wartość względem wartości wprowadzonej w innej kontrolce wejściowej względem stałej wartości lub względem odpowiedniego typu danych, ustawiając CompareValidator.Operator właściwość na ValidationCompareOperator.DataTypeCheckwartość .
CustomValidator Weryfikuje wartość przy użyciu procedury weryfikacji niestandardowej dostarczonej przez użytkownika.
RangeValidator Sprawdza, czy wartość znajduje się w zakresie wartości.
RegularExpressionValidator Weryfikuje wartość przy użyciu wyrażenia regularnego.
RequiredFieldValidator Sprawdza, czy wartość została wprowadzona w wymaganym polu.

Kontrolki sprawdzania poprawności zawsze weryfikują skojarzona kontrolkę wejściową na serwerze. Kontrolki weryfikacji mają również kompletną implementację po stronie klienta, która umożliwia przeglądarkom obsługującym skrypty (takim jak Microsoft Internet Explorer w wersji 4.0 lub nowszej) przeprowadzenie weryfikacji na kliencie. Walidacja po stronie klienta zwiększa proces weryfikacji, sprawdzając dane wejściowe użytkownika przed wysłaniem ich na serwer. Pozwala to wykrywać błędy na kliencie przed przesłanym formularzem, unikając rundy informacji niezbędnych do weryfikacji po stronie serwera.

Aby zweryfikować różne kryteria, można użyć wielu kontrolek walidacji z pojedynczą kontrolką wejściową. Można na przykład zastosować wiele kontrolek weryfikacji w kontrolce TextBox . Możesz użyć RangeValidator kontrolki, aby upewnić się, że wartość wprowadzona w kontrolce TextBox mieści się w określonym zakresie, a kontrolka RequiredFieldValidator w celu zapewnienia, że użytkownik wprowadzi wartość.

ASP.NET zapewnia wiele kontrolek, które mają możliwość ponownego publikowania na serwerze. Gdy jedna z tych kontrolek ma właściwość CausesValidation ustawioną na true, walidacja jest wykonywana, gdy kontrolka publikuje z powrotem na serwerze. Następujące kontrolki mają możliwość ponownego publikowania na serwerze:

Uwaga

Niektóre z tych kontrolek publikują z powrotem na serwerze tylko wtedy, gdy właściwość jest ustawiona AutoPostBack na true.

Te kontrolki mają ValidationGroup właściwość, która po ustawieniu weryfikuje tylko kontrolki sprawdzania poprawności w określonej grupie, gdy kontrolka wyzwala post z powrotem do serwera. Aby zgrupować kontrolki walidacji, ustaw ValidationGroup właściwość każdej kontrolki weryfikacji na tę samą wartość.

Aby skojarzyć kontrolkę wejściową z kontrolką walidacji, użyj ControlToValidate właściwości . Aby określić tekst do wyświetlenia w kontrolce weryfikacji, gdy walidacja zakończy się niepowodzeniem, użyj Text właściwości . Możesz również wyświetlić podsumowanie wszystkich kontrolek, które kończą się niepowodzeniem walidacji na stronie przy użyciu kontrolki ValidationSummary . Aby określić tekst do wyświetlenia w kontrolce ValidationSummary , użyj ErrorMessage właściwości .

Uwaga

Jeśli właściwość zostanie ustawiona ErrorMessage bez ustawienia Text właściwości, wartość ErrorMessage właściwości będzie również wyświetlana w kontrolce walidacji.

W przypadku korzystania z kontrolek modułu sprawdzania poprawności po stronie serwera należy zawsze sprawdzać wyniki weryfikacji po stronie serwera przed wykonaniem dowolnego przetwarzania. Po wycofaniu, ale przed wywołaniami metod zdarzeń strona wywołuje kontrolki modułu Page.IsValid sprawdzania poprawności i agreguje ich wyniki we właściwości. (Kontrolki modułu sprawdzania poprawności można również wywołać jawnie przy użyciu Validate metody ). We własnym kodzie należy sprawdzić, czy Page.IsValid właściwość jest zwracana true przed przetworzeniem danych wejściowych. Mimo że przeglądarki z obsługą skryptów mogą uniemożliwić powrót po awarii na kliencie, jeśli sprawdzanie poprawności nie powiodło się, przed przetworzeniem zweryfikowanych danych zawsze należy również zaewidencjonować Page.IsValid kod serwera.

Możesz również ręcznie przeprowadzić walidację. Aby zweryfikować wszystkie kontrolki weryfikacji na stronie, użyj Page.Validate metody . Poszczególne kontrolki weryfikacji można zweryfikować przy użyciu Validate metody kontrolki.

Uwaga

Jeśli używasz Page.IsValid właściwości w metodzie Page_Load , musisz najpierw jawnie wywołać metodę Page.Validate . Ponieważ walidacja występuje po Control.Load zdarzeniu dla strony, ale przed procedurą obsługi Click zdarzeń lub CommandPage.IsValid właściwość nie jest aktualizowana, dopóki Page.Validate metoda nie zostanie wywołana. Alternatywnie możesz umieścić kod w procedurze obsługi zdarzeń dla Click zdarzenia lub Command zamiast Page_Load metody .

Nie wszystkie kontrolki serwera sieci Web obsługują kontrolki sprawdzania poprawności. Standardowe kontrolki, które można zweryfikować za pomocą kontrolki sprawdzania poprawności, to:

Uwaga

Aby kontrolka wejściowa została zweryfikowana, System.Web.UI.ValidationPropertyAttribute należy zastosować atrybut do kontrolki.

Uwaga

W przypadku używania kontrolek modułu sprawdzania poprawności, które pochodzą z BaseValidator wewnątrz UpdatePanel kontrolki, upewnij się, że kontrolka modułu sprawdzania poprawności i skojarzona z nią kontrolka znajdują się w tym samym panelu. Aby uzyskać więcej informacji na temat korzystania z kontrolki UpdatePanel w przypadku aktualizacji częściowych stron, zobacz Częściowe renderowanie stron — omówienie.

W przypadku niepowodzenia walidacji można ustawić fokus na skojarzonej kontrolce wejściowej SetFocusOnError , ustawiając właściwość na truewartość .

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia programu BaseValidator, zobacz BaseValidator konstruktor.

Ułatwienia dostępu

Aby uzyskać informacje o sposobie konfigurowania tej kontrolki tak, aby generowała znaczniki zgodne ze standardami ułatwień dostępu, zobacz Ułatwienia dostępu w programie Visual Studio i ASP.NET oraz kontrolki i ułatwienia dostępu ASP.NET.

Uwagi dotyczące implementowania

Po dziedziczeniu BaseValidator z klasy należy zastąpić następujący element członkowski: EvaluateIsValid().

Konstruktory

BaseValidator()

Inicjuje nowe wystąpienie klasy BaseValidator.

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

Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę.

(Odziedziczone po Control)
AssociatedControlID

Ta właściwość nie jest obsługiwana.

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 tego formantu.

(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 kontrolki podrzędne kontrolki serwera zostały utworzone.

(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 ClientID wartości 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)
ControlToValidate

Pobiera lub ustawia kontrolkę wejściową w celu zweryfikowania.

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

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.

(Odziedziczone po Control)
Display

Pobiera lub ustawia zachowanie wyświetlania komunikatu o błędzie w kontrolce walidacji.

EnableClientScript

Pobiera lub ustawia wartość wskazującą, czy jest włączona weryfikacja po stronie klienta.

Enabled

Pobiera lub ustawia wartość wskazującą, czy kontrolka walidacji jest włączona.

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 wysyłającego żądanie.

(Odziedziczone po Control)
ErrorMessage

Pobiera lub ustawia tekst komunikatu o błędzie wyświetlanego w kontrolce, gdy walidacja zakończy się niepowodzeniem ValidationSummary .

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ą serwera sieci Web.

(Odziedziczone po WebControl)
ForeColor

Pobiera lub ustawia kolor komunikatu wyświetlanego w przypadku niepowodzenia walidacji.

HasAttributes

Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty.

(Odziedziczone po WebControl)
HasChildViewState

Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają 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)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli.

(Odziedziczone po Control)
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)
IsUnobtrusive

Pobiera wartość wskazującą, czy kontrolka generuje dyskretny kod JavaScript.

IsValid

Pobiera lub ustawia wartość wskazującą, czy skojarzona kontrolka wejściowa przechodzi walidację.

IsViewStateEnabled

Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku.

(Odziedziczone po Control)
LoadViewStateByID

Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu.

(Odziedziczone po Control)
NamingContainer

Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości.

(Odziedziczone po Control)
Page

Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami.

(Odziedziczone po Control)
PropertiesValid

Pobiera wartość wskazującą, czy kontrolka określona ControlToValidate przez właściwość jest prawidłową kontrolką.

RenderingCompatibility

Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny.

(Odziedziczone po Control)
RenderUplevel

Pobiera wartość wskazującą, czy przeglądarka klienta obsługuje renderowanie "uplevel".

SetFocusOnError

Pobiera lub ustawia wartość wskazującą, czy fokus jest ustawiony na kontrolkę określoną przez właściwość, gdy walidacja zakończy się niepowodzeniem ControlToValidate .

Site

Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórę do zastosowania w kontrolce.

(Odziedziczone po WebControl)
Style

Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu w 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 ma wartość false.

(Odziedziczone po Label)
TabIndex

Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web.

(Odziedziczone po WebControl)
TagKey

Pobiera tag HTML używany do renderowania kontrolki Label .

(Odziedziczone po Label)
TagName

Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów kontrolek.

(Odziedziczone po WebControl)
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)
Text

Pobiera lub ustawia tekst wyświetlany w kontrolce walidacji, gdy walidacja zakończy się niepowodzeniem.

Text

Pobiera lub ustawia zawartość tekstowa kontrolki Label .

(Odziedziczone po Label)
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 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)
ValidationGroup

Pobiera lub ustawia nazwę grupy weryfikacji, do której należy ta kontrolka sprawdzania poprawności.

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 muszą być renderowane dla kontrolki do określonego HtmlTextWriter obiektu.

AddedControl(Control, Int32)

Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Powiadamia kontrolkę, że element został przeanalizowany i dodaje element do kontrolki Label .

(Odziedziczone po Label)
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 danych renderowania w czasie projektowania.

(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)
CheckControlValidationProperty(String, String)

Sprawdza, czy określona kontrolka znajduje się na stronie i zawiera właściwości weryfikacji.

ClearCachedClientID()

Ustawia wartość buforowanej ClientID na nullwartość .

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i stanie sterowania 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 Inheritwartość .

(Odziedziczone po Control)
ControlPropertiesValid()

Określa, czy kontrolka określona ControlToValidate przez właściwość jest prawidłową kontrolką.

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ę strony 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.

(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)
DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi.

(Odziedziczone po Control)
DataBind(Boolean)

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia.

(Odziedziczone po Control)
DataBindChildren()

Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera.

(Odziedziczone po Control)
DetermineRenderUplevel()

Określa, czy kontrolka sprawdzania poprawności może przeprowadzać walidację po stronie klienta.

Dispose()

Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Kończy śledzenie danych renderowania w czasie projektowania.

(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)
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)
EvaluateIsValid()

Po zastąpieniu w klasie pochodnej ta metoda zawiera kod określający, czy wartość w kontrolce wejściowej jest prawidłowa.

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 , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody .

(Odziedziczone po Control)
Focus()

Ustawia fokus danych wejściowych na kontrolkę.

(Odziedziczone po Control)
GetControlRenderID(String)

Pobiera identyfikator klienta określonej kontrolki.

GetControlValidationValue(String)

Pobiera wartość skojarzona z określoną kontrolką wejściową.

GetDesignModeState()

Pobiera dane czasu 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 wartość bieżącego wystąpienia.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki.

(Odziedziczone po Control)
GetValidationProperty(Object)

Określa właściwość walidacji kontrolki (jeśli istnieje).

HasControls()

Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych.

(Odziedziczone po Control)
IsLiteralContent()

Określa, czy kontrolka serwera przechowuje 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)

Ładuje wcześniej zapisany stan dla kontrolki.

(Odziedziczone po Label)
MapPathSecure(String)

Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MergeStyle(Style)

Kopiuje wszystkie niepuste 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 kontrolek.

(Odziedziczone po WebControl)
OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.

(Odziedziczone po Control)
OnDataBinding(EventArgs)

DataBinding Zgłasza zdarzenie.

(Odziedziczone po Control)
OnInit(EventArgs)

Init Zgłasza zdarzenie.

OnLoad(EventArgs)

Load Zgłasza zdarzenie.

(Odziedziczone po Control)
OnPreRender(EventArgs)

PreRender Zgłasza zdarzenie.

OnUnload(EventArgs)

Unload Zgłasza zdarzenie.

OpenFile(String)

Pobiera element Stream używany do odczytywania pliku.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki.

(Odziedziczone po Control)
RegisterValidatorCommonScript()

Rejestruje kod na stronie na potrzeby weryfikacji po stronie klienta.

RegisterValidatorDeclaration()

Rejestruje deklarację tablicy ECMAScript przy użyciu nazwy Page_Validatorstablicy .

RemovedControl(Control)

Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Wyświetla kontrolkę na kliencie.

RenderBeginTag(HtmlTextWriter)

Renderuje tag otwierania HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów kontrolek.

(Odziedziczone po WebControl)
RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.

(Odziedziczone po Control)
RenderContents(HtmlTextWriter)

Renderuje zawartość obiektu Label do określonego składnika zapisywania.

(Odziedziczone po Label)
RenderControl(HtmlTextWriter)

Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego 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 kontrolek.

(Odziedziczone po WebControl)
ResolveAdapter()

Pobiera kartę sterową 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)
SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości 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)
Validate()

Przeprowadza walidację na skojarzonej kontrolce danych wejściowych i aktualizuje IsValid właściwość .

Zdarzenia

DataBinding

Występuje, gdy kontrolka serwera wiąże się ze źródłem danych.

(Odziedziczone po Control)
Disposed

Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony 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 członka, 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

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

Zobacz też