CustomValidator Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Esegue la convalida definita dall'utente su un controllo di input.

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

Ereditarietà: Object

Control

WebControl

Label

BaseValidator
CustomValidator

Esempio

Nell'esempio di codice seguente viene illustrato come creare un controllo lato CustomValidator server.

Importante

In questo esempio è presente una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di script.


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

Nell'esempio di codice seguente viene illustrato come creare un controllo lato CustomValidator client.

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

Commenti

Usare il CustomValidator controllo per fornire una funzione di convalida definita dall'utente per un controllo di input. Il CustomValidator controllo è un controllo separato dal controllo di input convalidato, che consente di controllare dove viene visualizzato il messaggio di convalida.

I controlli di convalida eseguono sempre la convalida nel server. Hanno anche un'implementazione lato client completa che consente ai browser abilitati per script (ad esempio Microsoft Internet Explorer 4.0 e versioni successive) di eseguire la convalida sul client. La convalida lato client migliora il processo di convalida controllando l'input dell'utente prima che venga inviato al server. Ciò consente di rilevare errori nel client prima dell'invio del modulo, evitando così il round trip delle informazioni necessarie per la convalida lato server.

Per creare una funzione di convalida lato server, fornire un gestore per l'evento ServerValidate che esegue la convalida. È possibile accedere alla stringa del controllo di input da convalidare usando la Value proprietà dell'oggetto ServerValidateEventArgs passato al gestore eventi come parametro. Il risultato della convalida viene quindi archiviato nella IsValid proprietà dell'oggetto ServerValidateEventArgs .

Per creare una funzione di convalida lato client, aggiungere prima di tutto la funzione di convalida lato server descritta in precedenza. Aggiungere quindi la funzione script di convalida sul lato client alla pagina ASP.NET (.aspx).

Se si usa Visual Basic Scripting Edition (VBScript), la funzione deve essere in questo formato:

Sub ValidationFunctionName(source, arguments)

Se si usa JScript, la funzione deve essere in questo formato:

function ValidationFunctionName(source, arguments)

Il source parametro è un riferimento all'elemento <span> sottoposto a rendering per il CustomValidator controllo . In questo modo è possibile controllare a livello di codice il <tag span> , ad esempio la modifica dell'attributo InnerHtml . Il arguments parametro è un oggetto con due proprietà: Value e IsValid. Questo parametro consente di ottenere il valore del controllo da convalidare e di indicare se il valore è valido in base alla routine di convalida personalizzata.

Utilizzare la ClientValidationFunction proprietà per specificare il nome della funzione script di convalida lato client associata al CustomValidator controllo . Poiché la funzione script viene eseguita nel client, la funzione deve trovarsi in un linguaggio supportato dal browser di destinazione, ad esempio VBScript o JScript.

Annotazioni

Quando si usa il CustomValidator controllo all'interno di un UpdatePanel controllo, assicurarsi che il controllo validator e il controllo a cui è associato si trovino nello stesso pannello. Per altre informazioni sull'uso del UpdatePanel controllo per gli aggiornamenti a pagina parziale, vedere Partial-Page Panoramica del rendering.

Analogamente alla convalida lato server, la stringa del controllo di input da convalidare è accessibile usando la Value proprietà del arguments parametro . Restituire il risultato della convalida impostando la IsValid proprietà del arguments parametro .

Attenzione

Quando si usano i controlli validator, è consigliabile controllare sempre i risultati della convalida lato server prima di eseguire qualsiasi elaborazione. Dopo un postback ma prima che vengano chiamati i metodi di evento, la pagina chiama i controlli validator e aggrega i risultati nella Page.IsValid proprietà . È anche possibile chiamare i controlli validator in modo esplicito usando il Validate metodo . Nel codice è necessario verificare che la proprietà venga restituita true prima dell'elaborazione Page.IsValid dell'input. Anche se i browser abilitati per script potrebbero impedire l'esecuzione di un postback nel client se un controllo di convalida non è riuscito, è consigliabile archiviare sempre il Page.IsValid codice del server prima di elaborare i dati convalidati.

È possibile usare più controlli di convalida con un singolo controllo di input per convalidare criteri diversi. Ad esempio, è possibile applicare più controlli di convalida su un TextBox controllo che consente all'utente di immettere la quantità di articoli da aggiungere a un carrello acquisti. È possibile utilizzare un CustomValidator controllo per assicurarsi che il valore specificato sia minore dell'importo nell'inventario e un RequiredFieldValidator controllo per assicurarsi che l'utente immetta un valore nel TextBox controllo.

Annotazioni

Se il controllo di input è vuoto, non vengono chiamate funzioni di convalida e la convalida ha esito positivo. Usare un RequiredFieldValidator controllo per richiedere all'utente di immettere i dati nel controllo di input.

È possibile utilizzare un CustomValidator controllo senza impostare la ControlToValidate proprietà . Questa operazione viene in genere eseguita quando si convalidano più controlli di input o si convalidano controlli di input che non possono essere usati con controlli di convalida, ad esempio il CheckBox controllo . In questo caso, la Value proprietà del arguments parametro passato al gestore eventi per l'evento ServerValidate e alla funzione di convalida lato client contiene sempre una stringa vuota (""). Tuttavia, queste funzioni di convalida vengono ancora chiamate, se appropriate, per determinare la validità sia nel server che nel client. Per accedere al valore da convalidare, è necessario fare riferimento al controllo di input da convalidare a livello di codice e quindi recuperare il valore dalla proprietà appropriata. Ad esempio, per convalidare un CheckBox controllo nel server, non impostare la ControlToValidate proprietà del controllo di convalida e utilizzare il codice seguente per il gestore per l'evento ServerValidate .

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);
 }

Per altre informazioni sui controlli di convalida, vedere BaseValidator.

Accessibilità

Per informazioni su come configurare questo controllo in modo che generi markup conforme agli standard di accessibilità, vedere Accessibilità in Visual Studio e ASP.NET e controlli ASP.NET e accessibilità.

Costruttori

Nome	Descrizione
CustomValidator()	Inizializza una nuova istanza della classe CustomValidator.

Proprietà

Nome	Descrizione
AccessKey	Ottiene o imposta la chiave di accesso che consente di passare rapidamente al controllo server Web. (Ereditato da WebControl)
Adapter	Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control)
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control)
AssociatedControlID	Questa proprietà non è supportata. (Ereditato da BaseValidator)
Attributes	Ottiene la raccolta di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
BackColor	Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
BindingContainer	Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control)
BorderColor	Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
BorderStyle	Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
BorderWidth	Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
ChildControlsCreated	Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà . (Ereditato da Control)
ClientIDSeparator	Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control)
ClientValidationFunction	Ottiene o imposta il nome della funzione script lato client personalizzata utilizzata per la convalida.
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control)
ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlStyleCreated	Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlToValidate	Ottiene o imposta il controllo di input da convalidare. (Ereditato da BaseValidator)
CssClass	Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel client. (Ereditato da WebControl)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Display	Ottiene o imposta il comportamento di visualizzazione del messaggio di errore in un controllo di convalida. (Ereditato da BaseValidator)
EnableClientScript	Ottiene o imposta un valore che indica se la convalida lato client è abilitata. (Ereditato da BaseValidator)
Enabled	Ottiene o imposta un valore che indica se il controllo di convalida è abilitato. (Ereditato da BaseValidator)
EnableTheming	Ottiene o imposta un valore che indica se i temi si applicano a questo controllo. (Ereditato da WebControl)
EnableViewState	Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control)
ErrorMessage	Ottiene o imposta il testo per il messaggio di errore visualizzato in un ValidationSummary controllo quando la convalida non riesce. (Ereditato da BaseValidator)
Events	Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control)
Font	Ottiene le proprietà del tipo di carattere associate al controllo server Web. (Ereditato da WebControl)
ForeColor	Ottiene o imposta il colore del messaggio visualizzato quando la convalida non riesce. (Ereditato da BaseValidator)
HasAttributes	Ottiene un valore che indica se il controllo dispone di attributi impostati. (Ereditato da WebControl)
HasChildViewState	Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
ID	Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control)
IsEnabled	Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control)
IsUnobtrusive	Ottiene un valore che indica se il controllo genera JavaScript non invadente. (Ereditato da BaseValidator)
IsValid	Ottiene o imposta un valore che indica se il controllo di input associato supera la convalida. (Ereditato da BaseValidator)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control)
LoadViewStateByID	Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control)
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control)
PropertiesValid	Ottiene un valore che indica se il controllo specificato dalla ControlToValidate proprietà è un controllo valido. (Ereditato da BaseValidator)
RenderingCompatibility	Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control)
RenderUplevel	Ottiene un valore che indica se il browser del client supporta il rendering "uplevel". (Ereditato da BaseValidator)
SetFocusOnError	Ottiene o imposta un valore che indica se lo stato attivo è impostato sul controllo specificato dalla proprietà quando la ControlToValidate convalida ha esito negativo. (Ereditato da BaseValidator)
Site	Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da WebControl)
Style	Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento `disabled` HTML sottoposto a rendering su "disabled" quando la proprietà del IsEnabled controllo è `false`. (Ereditato da Label)
TabIndex	Ottiene o imposta l'indice della scheda del controllo server Web. (Ereditato da WebControl)
TagKey	Ottiene il tag HTML utilizzato per eseguire il rendering del Label controllo. (Ereditato da Label)
TagName	Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TemplateControl	Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control)
Text	Ottiene o imposta il testo visualizzato nel controllo di convalida quando la convalida ha esito negativo. (Ereditato da BaseValidator)
ToolTip	Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web. (Ereditato da WebControl)
UniqueID	Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control)
ValidateEmptyText	Ottiene o imposta un valore booleano che indica se il testo vuoto deve essere convalidato.
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control)
ValidationGroup	Ottiene o imposta il nome del gruppo di convalida a cui appartiene questo controllo di convalida. (Ereditato da BaseValidator)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control)
Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)

Metodi

Nome	Descrizione
AddAttributesToRender(HtmlTextWriter)	Aggiunge le proprietà del controllo al flusso di CustomValidator output per il rendering nel client.
AddedControl(Control, Int32)	Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo che un elemento è stato analizzato e aggiunge l'elemento al Label controllo . (Ereditato da Label)
ApplyStyle(Style)	Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ApplyStyleSheetSkin(Page)	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control)
CheckControlValidationProperty(String, String)	Verifica se il controllo specificato si trova nella pagina e contiene proprietà di convalida. (Ereditato da BaseValidator)
ClearCachedClientID()	Imposta il valore memorizzato nella ClientID cache su `null`. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
ControlPropertiesValid()	Controlla le proprietà del controllo per i valori validi.
CopyBaseAttributes(WebControl)	Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web da cui viene chiamato questo metodo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateChildControls()	Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control)
CreateControlCollection()	Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da Control)
CreateControlStyle()	Crea l'oggetto stile utilizzato internamente dalla WebControl classe per implementare tutte le proprietà correlate allo stile. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control)
DataBind(Boolean)	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control)
DataBindChildren()	Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control)
DetermineRenderUplevel()	Determina se il controllo di convalida può eseguire la convalida lato client. (Ereditato da BaseValidator)
Dispose()	Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
EvaluateIsValid()	Esegue l'override del EvaluateIsValid() metodo .
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato `id` e un numero intero, specificato nel `pathOffset` parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo . (Ereditato da Control)
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato `id` . (Ereditato da Control)
Focus()	Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control)
GetControlRenderID(String)	Ottiene l'ID client del controllo specificato. (Ereditato da BaseValidator)
GetControlValidationValue(String)	Ottiene il valore associato al controllo di input specificato. (Ereditato da BaseValidator)
GetDesignModeState()	Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control)
IsLiteralContent()	Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control)
LoadViewState(Object)	Carica lo stato salvato in precedenza per il controllo . (Ereditato da Label)
MapPathSecure(String)	Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MergeStyle(Style)	Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da Control)
OnInit(EventArgs)	Genera l'evento Init. (Ereditato da BaseValidator)
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnPreRender(EventArgs)	Genera l'evento PreRender. (Ereditato da BaseValidator)
OnServerValidate(String)	Genera l'evento ServerValidate per il CustomValidator controllo .
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da BaseValidator)
OpenFile(String)	Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)	Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control)
RegisterValidatorCommonScript()	Registra il codice nella pagina per la convalida lato client. (Ereditato da BaseValidator)
RegisterValidatorDeclaration()	Registra una dichiarazione di matrice ECMAScript usando il nome `Page_Validators`della matrice . (Ereditato da BaseValidator)
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control)
Render(HtmlTextWriter)	Visualizza il controllo nel client. (Ereditato da BaseValidator)
RenderBeginTag(HtmlTextWriter)	Esegue il rendering del tag di apertura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderContents(HtmlTextWriter)	Esegue il rendering del contenuto dell'oggetto Label nel writer specificato. (Ereditato da Label)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag di chiusura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ResolveAdapter()	Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control)
SaveControlState()	Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control)
SaveViewState()	Salva qualsiasi stato modificato dopo che il TrackViewState() metodo è stato richiamato. (Ereditato da WebControl)
SetDesignModeState(IDictionary)	Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Fa in modo che il controllo possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà dell'oggetto ViewState . (Ereditato da WebControl)
Validate()	Esegue la convalida sul controllo di input associato e aggiorna la IsValid proprietà . (Ereditato da BaseValidator)

Eventi

Nome	Descrizione
DataBinding	Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Disposed	Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control)
Load	Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control)
ServerValidate	Si verifica quando la convalida viene eseguita nel server.
Unload	Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IAttributeAccessor.GetAttribute(String)	Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)	Imposta un attributo del controllo Web sul nome e sul valore specificati. (Ereditato da WebControl)
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)

Metodi di estensione

Nome	Descrizione
FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatable per il controllo dati contenitore.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?