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

Fungerar som den abstrakta basklassen för valideringskontroller.

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

Arv: Object

Control

WebControl

Label
BaseValidator

Härledda: System.Web.DynamicData.DynamicValidator

System.Web.UI.WebControls.BaseCompareValidator

System.Web.UI.WebControls.CustomValidator

System.Web.UI.WebControls.RegularExpressionValidator

System.Web.UI.WebControls.RequiredFieldValidator

Implementeringar: IValidator

Exempel

Följande kodexempel visar hur du använder flera valideringskontroller för att verifiera att användaren anger ett giltigt värde i en TextBox kontroll.

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#" %>

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

Kommentarer

Klassen BaseValidator tillhandahåller kärnimplementeringen för alla valideringskontroller. Verifieringskontroller används för att verifiera användarindata i en associerad indatakontroll. När användaren anger ett värde som inte kan valideras visas ett felmeddelande i verifieringskontrollen. Eftersom en valideringskontroll är skild från indatakontrollen kan du placera felmeddelandet var som helst på sidan i förhållande till indatakontrollen. ASP.NET innehåller flera verifieringskontroller som utför specifika typer av validering. I följande tabell beskrivs dessa kontroller.

Verifieringskontroll	Description
CompareValidator	Validerar ett värde mot det värde som anges i en annan indatakontroll, mot ett konstant värde eller mot en korrekt datatyp genom att ställa in CompareValidator.Operator egenskapen på ValidationCompareOperator.DataTypeCheck.
CustomValidator	Validerar ett värde med hjälp av en anpassad valideringsrutin som tillhandahålls av användaren.
RangeValidator	Verifierar om ett värde ligger inom ett värdeintervall.
RegularExpressionValidator	Validerar ett värde med ett reguljärt uttryck.
RequiredFieldValidator	Verifierar att ett värde har angetts i ett obligatoriskt fält.

Verifieringskontroller verifierar alltid den associerade indatakontrollen på servern. Valideringskontrollerna har också fullständig implementering på klientsidan som gör att skriptaktiverade webbläsare (till exempel Microsoft Internet Explorer version 4.0 och senare) kan utföra validering 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.

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. Du kan använda en RangeValidator kontroll för att säkerställa att värdet som anges i TextBox kontrollen ligger inom ett angivet intervall och en RequiredFieldValidator kontroll för att säkerställa att användaren anger ett värde.

ASP.NET innehåller många kontroller som kan skickas tillbaka till servern. När en av dessa kontroller har sin CausesValidation egenskap inställd truepå utförs verifieringen när kontrollen skickas tillbaka till servern. Följande kontroller har möjlighet att skicka tillbaka till servern:

Note

Vissa av dessa kontroller skickas bara tillbaka till servern när egenskapen AutoPostBack är inställd på true.

Dessa kontroller har var och en en ValidationGroup egenskap som, när den anges, endast validerar verifieringskontrollerna i den angivna gruppen när kontrollen utlöser ett inlägg tillbaka till servern. Om du vill gruppera verifieringskontroller anger du ValidationGroup egenskapen för varje valideringskontroll till samma värde.

Om du vill associera en indatakontroll med en verifieringskontroll använder du ControlToValidate egenskapen . Om du vill ange den text som ska visas i en valideringskontroll när verifieringen misslyckas använder du Text egenskapen . Du kan också visa en sammanfattning av alla kontroller som inte kan verifieras på sidan med hjälp av en ValidationSummary kontroll. Om du vill ange den text som ska visas i en ValidationSummary kontroll använder du egenskapen ErrorMessage .

Note

Om du anger ErrorMessage egenskapen utan att Text ange egenskapen visas även värdet för ErrorMessage egenskapen i verifieringskontrollen.

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.

Du kan också utföra validering manuellt. Om du vill verifiera alla verifieringskontroller på sidan använder du Page.Validate metoden. Enskilda verifieringskontroller kan verifieras med hjälp Validate av kontrollens metod.

Note

Om du använder egenskapen Page.IsValid i en Page_Load metod måste du först uttryckligen Page.Validate anropa metoden. Eftersom valideringen sker efter Control.Load händelsen för sidan, men före händelsehanteraren för Click eller-händelserna Command , Page.IsValid uppdateras inte egenskapen förrän Page.Validate metoden anropas. Alternativt kan du placera koden i händelsehanteraren för händelsen eller Click i stället för CommandPage_Load -metoden.

Alla webbserverkontroller stöder inte verifieringskontroller. Standardkontrollerna som kan verifieras med en verifieringskontroll är:

Note

För att en indatakontroll ska kunna verifieras System.Web.UI.ValidationPropertyAttribute måste attributet tillämpas på kontrollen.

Note

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

När valideringen misslyckas kan du ange fokus på den associerade indatakontrollen genom att ange SetFocusOnError egenskapen till true.

En lista över initiala egenskapsvärden för en instans av BaseValidatorfinns i BaseValidator konstruktorn.

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.

Anteckningar till implementerare

När du ärver från BaseValidator klassen måste du åsidosätta följande medlem: EvaluateIsValid().

Konstruktorer

Name	Description
BaseValidator()	Initierar en ny instans av BaseValidator 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.
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)
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.
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.
EnableClientScript	Hämtar eller anger ett värde som anger om validering på klientsidan är aktiverat.
Enabled	Hämtar eller anger ett värde som anger om verifieringskontrollen är aktiverad.
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.
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.
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.
IsValid	Hämtar eller anger ett värde som anger om den associerade indatakontrollen klarar valideringen.
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.
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.
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.
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.
Text	Hämtar eller anger textinnehållet i Label kontrollen. (Ärvd från Label)
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)
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.
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 HTML-attribut och formatmallar som måste återges för kontrollen till det angivna HtmlTextWriter objektet.
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.
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()	Avgör om kontrollen som anges av ControlToValidate egenskapen är en giltig kontroll.
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.
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()	När den åsidosättas i en härledd klass innehåller den här metoden koden för att avgöra om värdet i indatakontrollen är giltigt.
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.
GetControlValidationValue(String)	Hämtar värdet som är associerat med den angivna indatakontrollen.
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)
GetValidationProperty(Object)	Avgör verifieringsegenskapen för en kontroll (om den finns).
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 .
OnLoad(EventArgs)	Genererar händelsen Load . (Ärvd från Control)
OnPreRender(EventArgs)	Genererar händelsen PreRender .
OnUnload(EventArgs)	Genererar händelsen Unload .
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.
RegisterValidatorDeclaration()	Registrerar en ECMAScript-matrisdeklaration med matrisnamnet `Page_Validators`.
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.
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.

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