CustomValidator Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Utför användardefinierad validering på en indatakontroll.

public ref class CustomValidator : System::Web::UI::WebControls::BaseValidator

public class CustomValidator : System.Web.UI.WebControls.BaseValidator

type CustomValidator = class
    inherit BaseValidator

Public Class CustomValidator
Inherits BaseValidator

Arv: Object

Control

WebControl

Label

BaseValidator
CustomValidator

Exempel

Följande kodexempel visar hur du skapar en kontroll på serversidan CustomValidator .

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.


<%@ 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>CustomValidator ServerValidate Example</title>
<script runat="server">

      void ValidateBtn_OnClick(object sender, EventArgs e) 
      { 

         // Display whether the page passed validation.
         if (Page.IsValid) 
         {

            Message.Text = "Page is valid.";

         }

         else 
         {

            Message.Text = "Page is not valid!";

         }

      }

      void ServerValidation(object source, ServerValidateEventArgs args)
      {

         try 
         {

            // Test whether the value entered into the text box is even.
            int i = int.Parse(args.Value);
            args.IsValid = ((i%2) == 0);

         }

         catch(Exception ex)
         {

            args.IsValid = false;

         }

      }

   </script>    

</head>
<body>

   <form id="form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"  
           Text="Enter an even number:" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"
           AssociatedControlID="Text1"/>

      <br />

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Names="verdana" 
           Font-Size="10pt"
           OnServerValidate="ServerValidation"
           runat="server"/>

      <br />
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           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>CustomValidator ServerValidate Example</title>
<script runat="server">

      Sub ValidateBtn_OnClick(sender As Object, e As EventArgs) 

         ' Display whether the page passed validation.
         If Page.IsValid Then 

            Message.Text = "Page is valid."

         Else 

            Message.Text = "Page is not valid!"

         End If

      End Sub

      Sub ServerValidation(source As Object, args As ServerValidateEventArgs)

         Try 

            ' Test whether the value entered into the text box is even.
            Dim num As Integer = Integer.Parse(args.Value)
            args.IsValid = ((num mod 2) = 0)
 
         Catch ex As Exception
         
            args.IsValid = false

         End Try

      End Sub

   </script>    

</head>
<body>

   <form id="form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"
           Text="Enter an even number:" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"
           AssociatedControlID="Text1" />

      <br />

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Names="verdana" 
           Font-Size="10pt"
           OnServerValidate="ServerValidation"
           runat="server"/>

      <br />
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
  
</body>
</html>

I följande kodexempel visas hur du skapar en kontroll på klientsidan CustomValidator .

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

<html>
<head>

   <script runat="server">

      void ValidateBtn_OnClick(object sender, EventArgs e) 
      { 
         // Display whether the page passed validation.
         if (Page.IsValid) 
         {
            Message.Text = "Page is valid.";
         }

         else 
         {
            Message.Text = "Page is not valid!";
         }
      }

      void ServerValidation(object source, ServerValidateEventArgs args)
      {
         try 
         {
            // Test whether the value entered into the text box is even.
            int i = int.Parse(args.Value);
            args.IsValid = ((i%2) == 0);
         }

         catch(Exception ex)
         {
            args.IsValid = false;
         }
      }
       
   </script>    

</head>
<body>

   <form id="Form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"  
           Text="Enter an even number:" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <p>

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           ClientValidationFunction="ClientValidate"
           OnServerValidate="ServerValidation"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Name="verdana" 
           Font-Size="10pt"
           runat="server"/>

      <p>
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
</body>
</html>

<script language="javascript"> 
   function ClientValidate(source, arguments)
   {
        if (arguments.Value % 2 == 0 ){
            arguments.IsValid = true;
        } else {
            arguments.IsValid = false;
        }
   }
</script>

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      Sub ValidateBtn_OnClick(sender As Object, e As EventArgs) 
           ' Display whether the page passed validation.
           If Page.IsValid Then
               Message.Text = "Page is valid."
           Else
               Message.Text = "Page is not valid!"
           End If
       End Sub

      Sub ServerValidation(source As Object, args As ServerValidateEventArgs)
           Try
               ' Test whether the value entered into the text box is even.
               Dim num As Integer = Integer.Parse(args.Value)
               args.IsValid = ((num Mod 2) = 0)
           Catch ex As Exception
               args.IsValid = False
           End Try
       End Sub

   </script>      

</head>
<body>

   <form id="Form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"  
           Text="Enter an even number:" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <p>

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           ClientValidationFunction="ClientValidate"
           OnServerValidate="ServerValidation"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Name="verdana" 
           Font-Size="10pt"
           runat="server"/>

      <p>
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
  
</body>
</html>

<script language="javascript">
   function ClientValidate(source, arguments)
   {
        if (arguments.Value % 2 == 0 ){
            arguments.IsValid = true;
        } else {
            arguments.IsValid = false;
        }
   }
</script>

Kommentarer

Använd kontrollen CustomValidator för att tillhandahålla en användardefinierad valideringsfunktion för en indatakontroll. Kontrollen CustomValidator är en separat kontroll från den indatakontroll som verifieras, vilket gör att du kan styra var valideringsmeddelandet visas.

Verifieringskontroller utför alltid validering på servern. De har också fullständig implementering på klientsidan som gör att skriptaktiverade webbläsare (till exempel Microsoft Internet Explorer 4.0 och senare) kan utföra verifiering på klienten. Validering på klientsidan förbättrar valideringsprocessen genom att kontrollera indata från användaren innan den skickas till servern. Detta gör att fel kan identifieras på klienten innan formuläret skickas, vilket undviker den tur och retur-information som krävs för validering på serversidan.

Om du vill skapa en valideringsfunktion på serversidan anger du en hanterare för händelsen ServerValidate som utför valideringen. Strängen från indatakontrollen för att verifiera kan nås med hjälp Value av egenskapen för det ServerValidateEventArgs objekt som skickas till händelsehanteraren som en parameter. Resultatet av valideringen lagras sedan i IsValid objektets ServerValidateEventArgs egenskap.

Om du vill skapa en valideringsfunktion på klientsidan lägger du först till valideringsfunktionen på serversidan som beskrevs tidigare. Lägg sedan till valideringsskriptfunktionen på klientsidan på sidan ASP.NET (.aspx).

Om du använder VBScript (VBScript) måste funktionen vara i det här formuläret:

Sub ValidationFunctionName(source, arguments)

Om du använder JScript måste funktionen vara i det här formuläret:

function ValidationFunctionName(source, arguments)

Parametern source är en referens till span-elementet <> som återges CustomValidator för kontrollen. På så sätt kan du programmatiskt styra span-taggen<>, till exempel ändra InnerHtml attributet. Parametern arguments är ett objekt med två egenskaper: Value och IsValid. Med den här parametern kan du hämta värdet för kontrollen för att verifiera och ange om värdet är giltigt baserat på din anpassade valideringsrutin.

Använd egenskapen ClientValidationFunction för att ange namnet på den valideringsskriptfunktion på klientsidan som är associerad med CustomValidator kontrollen. Eftersom skriptfunktionen körs på klienten måste funktionen vara på ett språk som målwebbläsaren stöder, till exempel VBScript eller JScript.

Note

När du använder CustomValidator kontrollen i en UpdatePanel kontroll kontrollerar du att valideringskontrollen och kontrollen som den är associerad med finns på samma panel. Mer information om hur du använder UpdatePanel kontrollen för partiella siduppdateringar finns iPartial-Page Översikt över återgivning.

Precis som verifiering på serversidan används strängen från indatakontrollen som ska verifieras med hjälp Value av parameterns arguments egenskap. Returnera resultatet av valideringen genom att ange parameterns IsValidarguments egenskap.

Caution

När du använder valideringskontroller bör du alltid kontrollera resultatet av verifiering på serversidan innan du utför någon bearbetning. Efter ett återanrop men innan dina händelsemetoder anropas anropar sidan validatorkontrollerna och aggregerar deras resultat i Page.IsValid egenskapen. (Du kan också anropa valideringskontrollerna explicit med hjälp av Validate metoden.) I din egen kod bör du kontrollera att egenskapen Page.IsValid returnerar true innan du bearbetar indata. Även om skriptaktiverade webbläsare kan förhindra att en återställning sker på klienten om en valideringskontroll har misslyckats, bör du alltid också checka Page.IsValid in serverkoden innan du bearbetar verifierade data.

Flera verifieringskontroller kan användas med en enskild indatakontroll för att verifiera olika kriterier. Du kan till exempel använda flera valideringskontroller på en TextBox kontroll som gör att användaren kan ange antalet artiklar som ska läggas till i en kundvagn. Du kan använda en CustomValidator kontroll för att säkerställa att det angivna värdet är mindre än mängden i lagret och en RequiredFieldValidator kontroll för att säkerställa att användaren anger ett värde i TextBox kontrollen.

Note

Om indatakontrollen är tom anropas inga valideringsfunktioner och verifieringen lyckas. Använd en RequiredFieldValidator kontroll för att kräva att användaren anger data i indatakontrollen.

Du kan använda en CustomValidator kontroll utan att ange egenskapen ControlToValidate . Detta görs ofta när du verifierar flera indatakontroller eller validerar indatakontroller som inte kan användas med valideringskontroller, till exempel CheckBox kontrollen. I det här fallet Value innehåller egenskapen för parametern arguments som skickas till händelsehanteraren för ServerValidate händelsen och valideringsfunktionen på klientsidan alltid en tom sträng (""). Dessa valideringsfunktioner anropas dock fortfarande, där det är lämpligt, för att fastställa giltigheten på både servern och klienten. För att kunna verifiera värdet måste du programmatiskt referera till den indatakontroll som du vill verifiera och sedan hämta värdet från lämplig egenskap. Om du till exempel vill verifiera en CheckBox kontroll på servern ska du inte ange ControlToValidate verifieringskontrollens egenskap och använda följande kod för hanteraren för ServerValidate händelsen.

Sub ServerValidation (source As object, args As ServerValidateEventArgs)
    args.IsValid = (CheckBox1.Checked = True)
 End Sub

void ServerValidation (object source, ServerValidateEventArgs args)
 {
    args.IsValid = (CheckBox1.Checked == true);
 }

Mer information om verifieringskontroller finns i BaseValidator.

Tillgänglighet

Information om hur du konfigurerar den här kontrollen så att den genererar markering som överensstämmer med tillgänglighetsstandarder finns i Accessibility i Visual Studio och ASP.NET och ASP.NET Controls and Accessibility.

Konstruktorer

Name	Description
CustomValidator()	Initierar en ny instans av CustomValidator klassen.

Egenskaper

Name	Description
AccessKey	Hämtar eller anger åtkomstnyckeln som gör att du snabbt kan navigera till webbserverkontrollen. (Ärvd från WebControl)
Adapter	Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control)
AppRelativeTemplateSourceDirectory	Hämtar eller anger den programrelativa virtuella katalogen Page UserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control)
AssociatedControlID	Den här egenskapen stöds inte. (Ärvd från BaseValidator)
Attributes	Hämtar samlingen med godtyckliga attribut (endast för återgivning) som inte motsvarar egenskaperna i kontrollen. (Ärvd från WebControl)
BackColor	Hämtar eller anger bakgrundsfärgen för webbserverkontrollen. (Ärvd från WebControl)
BindingContainer	Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control)
BorderColor	Hämtar eller anger kantlinjefärgen för webbkontrollen. (Ärvd från WebControl)
BorderStyle	Hämtar eller anger kantlinjeformatet för webbserverkontrollen. (Ärvd från WebControl)
BorderWidth	Hämtar eller anger kantlinjebredden för webbserverkontrollen. (Ärvd från WebControl)
ChildControlsCreated	Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control)
ClientID	Hämtar kontroll-ID:t för HTML-kod som genereras av ASP.NET. (Ärvd från Control)
ClientIDMode	Hämtar eller anger den algoritm som används för att generera värdet för ClientID egenskapen. (Ärvd från Control)
ClientIDSeparator	Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control)
ClientValidationFunction	Hämtar eller anger namnet på den anpassade skriptfunktionen på klientsidan som används för validering.
Context	Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control)
Controls	Hämtar ett ControlCollection objekt som representerar de underordnade kontrollerna för en angiven serverkontroll i användargränssnittshierarkin. (Ärvd från Control)
ControlStyle	Hämtar formatmallen för webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
ControlStyleCreated	Hämtar ett värde som anger om ett Style objekt har skapats för egenskapen ControlStyle . Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
ControlToValidate	Hämtar eller anger indatakontrollen som ska verifieras. (Ärvd från BaseValidator)
CssClass	Hämtar eller anger css-klassen (Cascading Style Sheet) som återges av webbserverkontrollen på klienten. (Ärvd från WebControl)
DataItemContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control)
DataKeysContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control)
DesignMode	Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control)
Display	Hämtar eller anger visningsbeteendet för felmeddelandet i en verifieringskontroll. (Ärvd från BaseValidator)
EnableClientScript	Hämtar eller anger ett värde som anger om validering på klientsidan är aktiverat. (Ärvd från BaseValidator)
Enabled	Hämtar eller anger ett värde som anger om verifieringskontrollen är aktiverad. (Ärvd från BaseValidator)
EnableTheming	Hämtar eller anger ett värde som anger om teman ska gälla för den här kontrollen. (Ärvd från WebControl)
EnableViewState	Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control)
ErrorMessage	Hämtar eller anger texten för felmeddelandet som visas i en ValidationSummary kontroll när verifieringen misslyckas. (Ärvd från BaseValidator)
Events	Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control)
Font	Hämtar teckensnittsegenskaperna som är associerade med webbserverkontrollen. (Ärvd från WebControl)
ForeColor	Hämtar eller anger färgen på meddelandet som visas när verifieringen misslyckas. (Ärvd från BaseValidator)
HasAttributes	Hämtar ett värde som anger om kontrollen har attribut inställda. (Ärvd från WebControl)
HasChildViewState	Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control)
Height	Hämtar eller anger höjden på webbserverkontrollen. (Ärvd från WebControl)
ID	Hämtar eller anger den programmatiska identifierare som tilldelats serverkontrollen. (Ärvd från Control)
IdSeparator	Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control)
IsChildControlStateCleared	Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control)
IsEnabled	Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl)
IsTrackingViewState	Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control)
IsUnobtrusive	Hämtar ett värde som anger om kontrollen genererar diskret JavaScript. (Ärvd från BaseValidator)
IsValid	Hämtar eller anger ett värde som anger om den associerade indatakontrollen klarar valideringen. (Ärvd från BaseValidator)
IsViewStateEnabled	Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control)
LoadViewStateByID	Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control)
NamingContainer	Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control)
Page	Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control)
Parent	Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control)
PropertiesValid	Hämtar ett värde som anger om kontrollen som anges av ControlToValidate egenskapen är en giltig kontroll. (Ärvd från BaseValidator)
RenderingCompatibility	Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control)
RenderUplevel	Hämtar ett värde som anger om klientens webbläsare stöder "uplevel"-återgivning. (Ärvd från BaseValidator)
SetFocusOnError	Hämtar eller anger ett värde som anger om fokus är inställt på den kontroll som anges av egenskapen när verifieringen ControlToValidate misslyckas. (Ärvd från BaseValidator)
Site	Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control)
SkinID	Hämtar eller ställer in huden för att applicera på kontrollen. (Ärvd från WebControl)
Style	Hämtar en samling textattribut som återges som ett formatattribut på den yttre taggen för webbserverkontrollen. (Ärvd från WebControl)
SupportsDisabledAttribute	Hämtar ett värde som anger om kontrollen ska ange `disabled` attributet för det renderade HTML-elementet till "inaktiverat" när kontrollens IsEnabled egenskap är `false`. (Ärvd från Label)
TabIndex	Hämtar eller anger flikindexet för webbserverkontrollen. (Ärvd från WebControl)
TagKey	Hämtar HTML-taggen som används för att återge Label kontrollen. (Ärvd från Label)
TagName	Hämtar namnet på kontrolltaggen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
TemplateControl	Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control)
TemplateSourceDirectory	Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control)
Text	Hämtar eller anger texten som visas i verifieringskontrollen när verifieringen misslyckas. (Ärvd från BaseValidator)
ToolTip	Hämtar eller anger texten som visas när muspekaren hovrar över webbserverkontrollen. (Ärvd från WebControl)
UniqueID	Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control)
ValidateEmptyText	Hämtar eller anger ett booleskt värde som anger om tom text ska verifieras.
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control)
ValidationGroup	Hämtar eller anger namnet på den valideringsgrupp som verifieringskontrollen tillhör. (Ärvd från BaseValidator)
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control)
ViewStateIgnoresCase	Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control)
ViewStateMode	Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control)
Visible	Hämtar eller anger ett värde som anger om en serverkontroll återges som användargränssnitt på sidan. (Ärvd från Control)
Width	Hämtar eller anger bredden på webbserverkontrollen. (Ärvd från WebControl)

Metoder

Name	Description
AddAttributesToRender(HtmlTextWriter)	Lägger till egenskaperna för CustomValidator kontrollen i utdataströmmen för återgivning på klienten.
AddedControl(Control, Int32)	Anropas efter att en underordnad kontroll har lagts till i Controls Control objektets samling. (Ärvd från Control)
AddParsedSubObject(Object)	Meddelar kontrollen att ett element parsades och lägger till elementet i Label kontrollen. (Ärvd från Label)
ApplyStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen och skriver över alla befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ApplyStyleSheetSkin(Page)	Tillämpar formategenskaperna som definierats i sidformatmallen på kontrollen. (Ärvd från Control)
BeginRenderTracing(TextWriter, Object)	Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control)
BuildProfileTree(String, Boolean)	Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control)
CheckControlValidationProperty(String, String)	Verifierar om den angivna kontrollen finns på sidan och innehåller valideringsegenskaper. (Ärvd från BaseValidator)
ClearCachedClientID()	Anger det cachelagrade ClientID värdet till `null`. (Ärvd från Control)
ClearChildControlState()	Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildState()	Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildViewState()	Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearEffectiveClientIDMode()	Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control)
ControlPropertiesValid()	Kontrollerar egenskaperna för kontrollen efter giltiga värden.
CopyBaseAttributes(WebControl)	Kopierar egenskaperna som inte kapslas in av Style objektet från den angivna webbserverkontrollen till den webbserverkontroll som den här metoden anropas från. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
CreateChildControls()	Anropas av det ASP.NET sidramverket för att meddela serverkontroller som använder kompositionsbaserad implementering för att skapa underordnade kontroller som de innehåller som förberedelse för att publicera tillbaka eller återge. (Ärvd från Control)
CreateControlCollection()	Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från Control)
CreateControlStyle()	Skapar formatobjektet som används internt av WebControl klassen för att implementera alla formatrelaterade egenskaper. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
DataBind()	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. (Ärvd från Control)
DataBind(Boolean)	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control)
DataBindChildren()	Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control)
DetermineRenderUplevel()	Avgör om verifieringskontrollen kan utföra validering på klientsidan. (Ärvd från BaseValidator)
Dispose()	Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control)
EndRenderTracing(TextWriter, Object)	Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control)
EnsureChildControls()	Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control)
EnsureID()	Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
EvaluateIsValid()	Åsidosätter EvaluateIsValid() metoden.
FindControl(String, Int32)	Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna `id` och ett heltal som anges i parametern `pathOffset` , vilket underlättar sökningen. Du bör inte åsidosätta den här versionen av FindControl metoden. (Ärvd från Control)
FindControl(String)	Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna `id` parametern. (Ärvd från Control)
Focus()	Anger indatafokus till en kontroll. (Ärvd från Control)
GetControlRenderID(String)	Hämtar klient-ID för den angivna kontrollen. (Ärvd från BaseValidator)
GetControlValidationValue(String)	Hämtar värdet som är associerat med den angivna indatakontrollen. (Ärvd från BaseValidator)
GetDesignModeState()	Hämtar designtidsdata för en kontroll. (Ärvd från Control)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetRouteUrl(Object)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(String, Object)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetRouteUrl(String, RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
GetUniqueIDRelativeTo(Control)	Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control)
HasControls()	Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från Control)
HasEvents()	Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control)
IsLiteralContent()	Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control)
LoadControlState(Object)	Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control)
LoadViewState(Object)	Läser in det tidigare sparade tillståndet för kontrollen. (Ärvd från Label)
MapPathSecure(String)	Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MergeStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen, men skriver inte över några befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
OnBubbleEvent(Object, EventArgs)	Avgör om händelsen för serverkontrollen skickas upp på sidans UI-serverkontrollhierarki. (Ärvd från Control)
OnDataBinding(EventArgs)	Genererar händelsen DataBinding . (Ärvd från Control)
OnInit(EventArgs)	Genererar händelsen Init . (Ärvd från BaseValidator)
OnLoad(EventArgs)	Genererar händelsen Load . (Ärvd från Control)
OnPreRender(EventArgs)	Genererar händelsen PreRender . (Ärvd från BaseValidator)
OnServerValidate(String)	Genererar ServerValidate händelsen för CustomValidator kontrollen.
OnUnload(EventArgs)	Genererar händelsen Unload . (Ärvd från BaseValidator)
OpenFile(String)	Hämtar en Stream som används för att läsa en fil. (Ärvd från Control)
RaiseBubbleEvent(Object, EventArgs)	Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control)
RegisterValidatorCommonScript()	Registrerar kod på sidan för validering på klientsidan. (Ärvd från BaseValidator)
RegisterValidatorDeclaration()	Registrerar en ECMAScript-matrisdeklaration med matrisnamnet `Page_Validators`. (Ärvd från BaseValidator)
RemovedControl(Control)	Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control)
Render(HtmlTextWriter)	Visar kontrollen på klienten. (Ärvd från BaseValidator)
RenderBeginTag(HtmlTextWriter)	Renderar HTML-öppningstaggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
RenderChildren(HtmlTextWriter)	Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control)
RenderContents(HtmlTextWriter)	Renderar innehållet i den Label angivna skrivaren. (Ärvd från Label)
RenderControl(HtmlTextWriter, ControlAdapter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control)
RenderControl(HtmlTextWriter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från Control)
RenderEndTag(HtmlTextWriter)	Renderar HTML-avslutande taggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ResolveAdapter()	Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control)
ResolveClientUrl(String)	Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control)
ResolveUrl(String)	Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control)
SaveControlState()	Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control)
SaveViewState()	Sparar alla tillstånd som ändrades efter TrackViewState() att metoden anropades. (Ärvd från WebControl)
SetDesignModeState(IDictionary)	Anger designtidsdata för en kontroll. (Ärvd från Control)
SetRenderMethodDelegate(RenderMethod)	Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control)
SetTraceData(Object, Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
SetTraceData(Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
TrackViewState()	Gör att kontrollen spårar ändringar i dess visningstillstånd så att de kan lagras i objektets ViewState egenskap. (Ärvd från WebControl)
Validate()	Utför validering på den associerade indatakontrollen och uppdaterar IsValid egenskapen. (Ärvd från BaseValidator)

Händelser

Name	Description
DataBinding	Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control)
Disposed	Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control)
Init	Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control)
Load	Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control)
PreRender	Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control)
ServerValidate	Inträffar när verifieringen utförs på servern.
Unload	Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control)

Explicita gränssnittsimplementeringar

Name	Description
IAttributeAccessor.GetAttribute(String)	Hämtar ett attribut för webbkontrollen med det angivna namnet. (Ärvd från WebControl)
IAttributeAccessor.SetAttribute(String, String)	Anger ett attribut för webbkontrollen till det angivna namnet och värdet. (Ärvd från WebControl)
IControlBuilderAccessor.ControlBuilder	En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control)
IControlDesignerAccessor.GetDesignModeState()	En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control)
IControlDesignerAccessor.SetOwnerControl(Control)	En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control)
IControlDesignerAccessor.UserData	En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control)
IDataBindingsAccessor.DataBindings	En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control)
IDataBindingsAccessor.HasDataBindings	En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control)
IExpressionsAccessor.Expressions	En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control)
IExpressionsAccessor.HasExpressions	En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control)
IParserAccessor.AddParsedSubObject(Object)	En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control)

Tilläggsmetoder

Name	Description
FindDataSourceControl(Control)	Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen.
FindFieldTemplate(Control, String)	Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer.
FindMetaTable(Control)	Returnerar metatabellobjektet för den innehållande datakontrollen.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?