Udostępnij za pośrednictwem


CompareValidator Klasa

Definicja

Porównuje wartość wprowadzoną przez użytkownika w kontrolce wejściowej z wartością wprowadzoną w innej kontrolce wejściowej lub ze stałą wartością.

public ref class CompareValidator : System::Web::UI::WebControls::BaseCompareValidator
public class CompareValidator : System.Web.UI.WebControls.BaseCompareValidator
type CompareValidator = class
    inherit BaseCompareValidator
Public Class CompareValidator
Inherits BaseCompareValidator
Dziedziczenie

Przykłady

W poniższym przykładzie kodu pokazano, jak używać CompareValidator kontrolki do porównywania wartości w dwóch TextBox kontrolkach.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

<%@ 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>
    <title>CompareValidator Example</title>
<script runat="server">
 
      void Button_Click(Object sender, EventArgs e) 
      {
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "Result: Valid!";
         }
         else 
         {
            lblOutput.Text = "Result: Not valid!";
         }

      }
 
      void Operator_Index_Changed(Object sender, EventArgs e) 
      {

         Compare1.Operator = (ValidationCompareOperator) ListOperator.SelectedIndex;
         Compare1.Validate();

      }

      void Type_Index_Changed(Object sender, EventArgs e) 
      {

         Compare1.Type = (ValidationDataType) ListType.SelectedIndex;
         Compare1.Validate();

      }
 
   </script>
 
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>CompareValidator Example</h3>
      <br />
      Enter a value in each textbox. Select a comparison operator<br />
      and data type. Click "Validate" to compare values.
 
      <table style="background-color:#eeeeee; padding:10">

         <tr valign="top">

            <td>

               <h5>String 1:</h5>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>

            </td>

            <td>

               <h5>Comparison Operator:</h5>
 
               <asp:ListBox id="ListOperator" 
                    OnSelectedIndexChanged="Operator_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="True" Value="Equal">Equal</asp:ListItem>
                  <asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
                  <asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
                  <asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
                  <asp:ListItem Value="LessThan">LessThan</asp:ListItem>
                  <asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
                  <asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>

               </asp:ListBox>

            </td>

            <td>

               <h5>String 2:</h5>
               <asp:TextBox id="TextBox2" 
                    runat="server"/>
               <br />
               <asp:Button id="Button1"
                    Text="Validate"  
                    OnClick="Button_Click" 
                    runat="server"/>

            </td>
         </tr>

         <tr>
            <td colspan="3" align="center">

               <h5>Data Type:</h5>

               <asp:ListBox id="ListType" 
                    OnSelectedIndexChanged="Type_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="true" Value="String" >String</asp:ListItem>
                  <asp:ListItem Value="Integer" >Integer</asp:ListItem>
                  <asp:ListItem Value="Double" >Double</asp:ListItem>
                  <asp:ListItem Value="Date" >Date</asp:ListItem>
                  <asp:ListItem Value="Currency" >Currency</asp:ListItem>

               </asp:ListBox>
            </td>
         </tr>
      </table>
 
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1" 
           ControlToCompare="TextBox2"
           EnableClientScript="False" 
           Type="String" 
           runat="server"/>
 
      <br />
       
      <asp:Label id="lblOutput" 
           Font-Names="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </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>
    <title>CompareValidator Example</title>
<script runat="server">
 
      Sub Button_Click(sender As Object, e As EventArgs) 
 
         If Page.IsValid Then 
         
            lblOutput.Text = "Result: Valid!"
         
         Else 
         
            lblOutput.Text = "Result: Not valid!"
         
         End If

      End Sub
 
      Sub Operator_Index_Changed(sender As Object, e As EventArgs) 

         Compare1.Operator = CType(ListOperator.SelectedIndex, ValidationCompareOperator)
         Compare1.Validate()

      End Sub

      Sub Type_Index_Changed(sender As Object, e As EventArgs) 

         Compare1.Type = CType(ListType.SelectedIndex, ValidationDataType)
         Compare1.Validate()

      End Sub
 
   </script>
 
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>CompareValidator Example</h3>
      <br />
      Enter a value in each textbox. Select a comparison operator<br />
      and data type. Click "Validate" to compare values.
 
      <table style="background-color:#eeeeee; padding:10">

         <tr valign="top">

            <td>

               <h5>String 1:</h5>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>

            </td>

            <td>

               <h5>Comparison Operator:</h5>
 
               <asp:ListBox id="ListOperator" 
                    OnSelectedIndexChanged="Operator_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="True" Value="Equal">Equal</asp:ListItem>
                  <asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
                  <asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
                  <asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
                  <asp:ListItem Value="LessThan">LessThan</asp:ListItem>
                  <asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
                  <asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>

               </asp:ListBox>

            </td>

            <td>

               <h5>String 2:</h5>
               <asp:TextBox id="TextBox2" 
                    runat="server"/>
               <br />
               <asp:Button id="Button1"
                    Text="Validate"  
                    OnClick="Button_Click" 
                    runat="server"/>

            </td>
         </tr>

         <tr>
            <td colspan="3" align="center">

               <h5>Data Type:</h5>

               <asp:ListBox id="ListType" 
                    OnSelectedIndexChanged="Type_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="true" Value="String" >String</asp:ListItem>
                  <asp:ListItem Value="Integer" >Integer</asp:ListItem>
                  <asp:ListItem Value="Double" >Double</asp:ListItem>
                  <asp:ListItem Value="Date" >Date</asp:ListItem>
                  <asp:ListItem Value="Currency" >Currency</asp:ListItem>

               </asp:ListBox>
            </td>
         </tr>
      </table>
 
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1" 
           ControlToCompare="TextBox2"
           EnableClientScript="False" 
           Type="String" 
           runat="server"/>
 
      <br />
       
      <asp:Label id="lblOutput" 
           Font-Names="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

Uwagi

Użyj kontrolki CompareValidator , aby porównać wartość wprowadzoną przez użytkownika w kontrolce wejściowej, takiej jak kontrolka TextBox , z wartością wprowadzoną w innej kontrolce wejściowej lub stałą. Kontrolka CompareValidator przechodzi walidację, jeśli wartość kontrolki wejściowej jest zgodna z kryteriami określonymi Operatorprzez właściwości , ValueToComparei/lub ControlToCompare .

Możesz również użyć kontrolki CompareValidator , aby wskazać, czy wartość wprowadzona w kontrolce wejściowej może zostać przekonwertowana na typ danych określony przez BaseCompareValidator.Type właściwość .

Określ kontrolkę wejściową do zweryfikowania ControlToValidate , ustawiając właściwość . Jeśli chcesz porównać określoną kontrolkę wejściową z inną kontrolką wejściową, ustaw ControlToCompare właściwość , aby określić kontrolkę do porównania.

Uwaga

Jeśli wartość wprowadzona w kontrolce wejściowej określonej przez ControlToCompare właściwość nie może zostać przekonwertowana na typ danych określony przez BaseCompareValidator.Type właściwość, ale wartość wprowadzona w kontrolce wejściowej określonej przez ControlToValidate właściwość może zostać przekonwertowana, zweryfikowana kontrolka wejściowa jest uważana za prawidłową. W związku z tym należy również umieścić kontrolkę CompareValidator lub RangeValidator na kontrolce wejściowej ControlToCompare określonej przez właściwość .

Zamiast porównywać wartość kontrolki wejściowej z inną kontrolką wejściową, można porównać wartość kontrolki wejściowej z wartością stałą. Określ wartość stałą do porównania, ustawiając ValueToCompare właściwość .

Uwaga

Jeśli wartość określona przez ValueToCompare właściwość nie może zostać przekonwertowana na typ danych określony przez BaseCompareValidator.Type właściwość, zgłaszany jest wyjątek. Pamiętaj, aby sprawdzić typ danych wartości przed programowym przypisaniem jej do ValueToCompare właściwości.

Uwaga

Nie ustawiaj ControlToCompare jednocześnie właściwości i ValueToCompare . Możesz porównać wartość kontrolki wejściowej z inną kontrolką wejściową lub ze stałą wartością. Jeśli obie właściwości są ustawione, ControlToCompare właściwość ma pierwszeństwo.

Operator Użyj właściwości , aby określić typ porównania do wykonania, na przykład większe niż, równe itd. Jeśli ustawisz właściwość na wartość , CompareValidator kontrolka Operator ignoruje ControlToCompare właściwości i ValueToCompare i po prostu wskazuje, czy wartość wprowadzona w kontrolce wejściowej może zostać przekonwertowana na typ danych określony przez BaseCompareValidator.Type właściwość.ValidationCompareOperator.DataTypeCheck

Właściwość BaseCompareValidator.Type służy do określania typu danych obu wartości porównania. Obie wartości są automatycznie konwertowane na ten typ danych przed wykonaniem operacji porównania.

Ważne

Type Gdy właściwość jest ustawiona na Date , a bieżący typ kalendarza jest inny niż gregoriański, moduł sprawdzania poprawności wykonuje tylko walidację po stronie serwera. Skrypt klienta modułu sprawdzania poprawności obsługuje tylko kalendarze gregoriańskie.

W poniższej tabeli wymieniono różne typy danych, które można porównać.

Typ danych Opis
String Typ danych ciągu.
Integer 32-bitowy typ danych całkowitych ze znakiem.
Double Typ danych liczb zmiennoprzecinkowych o podwójnej precyzji.
Date Typ danych daty.
Currency Typ danych dziesiętnych. Nie może zawierać symboli waluty.

Uwaga

Jeśli kontrolka danych wejściowych jest pusta, żadne funkcje sprawdzania poprawności nie są wywoływane i walidacja zakończy się pomyślnie. Użyj kontrolki RequiredFieldValidator , aby wymagać od użytkownika wprowadzenia danych w kontrolce wejściowej.

Uwaga

Jeśli używasz kontrolki wewnątrz UpdatePanel kontrolki, upewnij się, że kontrolka modułu CompareValidator sprawdzania poprawności i kontrolka, z którą jest skojarzona, znajdują się w tym samym panelu. Aby uzyskać więcej informacji na temat używania kontrolki UpdatePanel do aktualizacji częściowych stron, zobacz Częściowe renderowanie stron — omówienie.

Aby uzyskać więcej informacji na temat kontrolek weryfikacji, zobacz BaseValidator.

Ułatwienia dostępu

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

Konstruktory

CompareValidator()

Inicjuje nowe wystąpienie klasy CompareValidator.

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.

(Odziedziczone po BaseValidator)
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 sterujących.

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

Pobiera lub ustawia kontrolkę wejściową w celu porównania z zweryfikowaną kontrolką wejściową.

ControlToValidate

Pobiera lub ustawia kontrolkę wprowadzania w celu zweryfikowania.

(Odziedziczone po BaseValidator)
CssClass

Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie.

(Odziedziczone po WebControl)
CultureInvariantValues

Pobiera lub ustawia wartość wskazującą, czy wartości są konwertowane na format neutralny dla kultury przed porównywaniem.

(Odziedziczone po BaseCompareValidator)
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.

(Odziedziczone po BaseValidator)
EnableClientScript

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

(Odziedziczone po BaseValidator)
Enabled

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

(Odziedziczone po BaseValidator)
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)
ErrorMessage

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

(Odziedziczone po BaseValidator)
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.

(Odziedziczone po BaseValidator)
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)
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 niestruwny kod JavaScript.

(Odziedziczone po BaseValidator)
IsValid

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

(Odziedziczone po BaseValidator)
IsViewStateEnabled

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

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

Pobiera lub ustawia operację porównania do wykonania.

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

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

(Odziedziczone po BaseValidator)
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".

(Odziedziczone po BaseValidator)
SetFocusOnError

Pobiera lub ustawia wartość wskazującą, czy fokus jest ustawiony na kontrolkę określoną przez właściwość w ControlToValidate przypadku niepowodzenia walidacji.

(Odziedziczone po BaseValidator)
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 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 sterujących.

(Odziedziczone po WebControl)
TemplateControl

Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny elementu 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.

(Odziedziczone po BaseValidator)
ToolTip

Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web.

(Odziedziczone po WebControl)
Type

Pobiera lub ustawia typ danych, na który są konwertowane porównywane wartości przed dokonaniem porównania.

(Odziedziczone po BaseCompareValidator)
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 walidacji, do której należy ta kontrolka walidacji.

(Odziedziczone po BaseValidator)
ValueToCompare

Pobiera lub ustawia stałą wartość do porównania z wartością wprowadzoną przez użytkownika w zweryfikowanej kontrolce danych wejściowych.

ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb stanu widoku 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 tej kontrolki do strumienia wyjściowego do renderowania na kliencie.

AddedControl(Control, Int32)

Wywoływana 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 elementy inne niż 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)
CheckControlValidationProperty(String, String)

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

(Odziedziczone po BaseValidator)
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)
ControlPropertiesValid()

Sprawdza właściwości kontrolki pod kątem prawidłowych wartości.

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 sterujących.

(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łu i serwera) kontrolki serwera.

(Odziedziczone po Control)
CreateControlStyle()

Tworzy obiekt stylu używany wewnętrznie przez klasę WebControl w celu zaimplementowania wszystkich właściwości powiązanych ze stylem. Ta metoda jest używana głównie przez deweloperów sterujących.

(Odziedziczone po WebControl)
DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi 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ą zgłaszania zdarzenia DataBinding .

(Odziedziczone po Control)
DataBindChildren()

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

(Odziedziczone po Control)
DetermineRenderUplevel()

Określa, czy kontrolka weryfikacji może być renderowana dla nowszej przeglądarki ("uplevel").

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

W przypadku zastąpienia 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 , 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)
GetControlRenderID(String)

Pobiera identyfikator klienta określonej kontrolki.

(Odziedziczone po BaseValidator)
GetControlValidationValue(String)

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

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

Ładuje wcześniej zapisany stan kontrolki.

(Odziedziczone po Label)
MapPathSecure(String)

Pobiera ścieżkę fizyczną, z którą jest mapowa ś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 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)
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.

(Odziedziczone po BaseValidator)
OnLoad(EventArgs)

Load Zgłasza zdarzenie.

(Odziedziczone po Control)
OnPreRender(EventArgs)

PreRender Zgłasza zdarzenie.

(Odziedziczone po BaseValidator)
OnUnload(EventArgs)

Unload Zgłasza zdarzenie.

(Odziedziczone po BaseValidator)
OpenFile(String)

Stream Pobiera element 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.

(Odziedziczone po BaseValidator)
RegisterValidatorDeclaration()

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

(Odziedziczone po BaseValidator)
RemovedControl(Control)

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

(Odziedziczone po Control)
Render(HtmlTextWriter)

Wyświetla kontrolkę na kliencie.

(Odziedziczone po BaseValidator)
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ść elementu Label do określonego składnika zapisywania.

(Odziedziczone po Label)
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)
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, aby można je było przechowywać we właściwości obiektu ViewState .

(Odziedziczone po WebControl)
Validate()

Przeprowadza walidację skojarzonej kontrolki wejściowej i aktualizuje IsValid właściwość.

(Odziedziczone po BaseValidator)

Zdarzenia

DataBinding

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

(Odziedziczone po Control)
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 elementu członkowskiego, zobacz GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, 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ż