RequiredFieldValidator Classe

Definição

Faz do controle de entrada associado um campo obrigatório.Makes the associated input control a required field.

public ref class RequiredFieldValidator : System::Web::UI::WebControls::BaseValidator
public class RequiredFieldValidator : System.Web.UI.WebControls.BaseValidator
type RequiredFieldValidator = class
    inherit BaseValidator
Public Class RequiredFieldValidator
Inherits BaseValidator
Herança
RequiredFieldValidator

Exemplos

O exemplo a seguir demonstra como usar o RequiredFieldValidator controle para garantir que o usuário insira um valor na caixa de texto.The following example demonstrates how to use the RequiredFieldValidator control to make sure that the user enters a value into the text box.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança.This example has a text box that accepts user input, which is a potential security threat. Por padrão, as páginas da Web do ASP.NET validam que a entrada do usuário não inclui elementos de script ou HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview.

<%@ 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>RequiredField Validator Example</title>
<script runat="server">
 
      void ValidateBtn_Click(Object sender, EventArgs e) 
      {
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "Required field is filled!";
         }
         else 
         {
            lblOutput.Text = "Required field is empty!";
         }
      }
 
   </script>
 
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>RequiredField Validator Example</h3>
 
      <table style="background-color:#eeeeee; padding:10">
         <tr valign="top">
            <td colspan="3">
               <asp:Label ID="lblOutput" 
                    Text="Fill in the required field below"
                    runat="server"
                    AssociatedControlID="TextBox1"/>
               <br />
            </td>
         </tr>
 
         <tr>
            <td colspan="3">
               <b>Credit Card Information</b>
            </td>
         </tr>
     
         <tr>
            <td align="right">
               Card Number:
            </td>
            <td>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>
            </td>
            <td>
               <asp:RequiredFieldValidator id="RequiredFieldValidator2"
                    ControlToValidate="TextBox1"
                    Display="Static"
                    ErrorMessage="*"
                    runat="server"/> 
            </td>
         </tr>
         <tr>
            <td></td>
            <td>
               <asp:Button id="Button1" 
                    Text="Validate" 
                    OnClick="ValidateBtn_Click" 
                    runat="server"/>
            </td>
            <td></td>
         </tr>
      </table>
 
   </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>RequiredField Validator Example</title>
<script runat="server">
 
      Sub ValidateBtn_Click(sender As Object, e As EventArgs) 
 
         If Page.IsValid Then 
         
            lblOutput.Text = "Required field is filled!"
         
         Else 
         
            lblOutput.Text = "Required field is empty!"
         
         End If

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

      <h3>RequiredField Validator Example</h3>
 
      <table style="background-color:#eeeeee; padding:10">
         <tr valign="top">
            <td colspan="3">
               <asp:Label ID="lblOutput" 
                    Text="Fill in the required field below"
                    runat="server"
                    AssociatedControlID="TextBox1"/>
               <br />
            </td>
         </tr>
 
         <tr>
            <td colspan="3">
               <b>Credit Card Information</b>
            </td>
         </tr>
     
         <tr>
            <td align="right">
               Card Number:
            </td>
            <td>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>
            </td>
            <td>
               <asp:RequiredFieldValidator id="RequiredFieldValidator2"
                    ControlToValidate="TextBox1"
                    Display="Static"
                    ErrorMessage="*"
                    runat="server"/> 
            </td>
         </tr>
         <tr>
            <td></td>
            <td>
               <asp:Button id="Button1" 
                    Text="Validate" 
                    OnClick="ValidateBtn_Click" 
                    runat="server"/>
            </td>
            <td></td>
         </tr>
      </table>
 
   </form>
 
</body>
</html>
    

<html>
<head>
   <script language="C#" runat=server>

      void ValidateBtn_Click(Object sender, EventArgs e) {

         if (Page.IsValid == true) {
            lblOutput.Text = "Required field is filled!";
         }
         else {
            lblOutput.Text = "Required field is empty!";
         }
      }

   </script>

</head>
<body>

<h3><font face="Verdana">RequiredField Validator Sample</font></h3>
<p>

<form runat="server">

   <table bgcolor="#eeeeee" cellpadding=10>
      <tr valign="top">
         <td colspan=3>
            <asp:Label ID="lblOutput" 
                 Text="Fill in the required field below"
                 ForeColor="red" 
                 Font-Name="Verdana" 
                 Font-Size="10" runat=server /><br>
         </td>
      </tr>

      <tr>
         <td colspan=3>
            <font face=Verdana size=2><b>Credit Card Information</b></font>
         </td>
      </tr>
    
      <tr>
         <td align=right>
            <font face=Verdana size=2>Card Number:</font>
         </td>
         <td>
            <asp:TextBox id=TextBox1 runat=server />
         </td>
         <td>
            <asp:RequiredFieldValidator id="RequiredFieldValidator2"
                 ControlToValidate="TextBox1"
                 Display="Static"
                 Width="100%" runat=server>
                 *
            </asp:RequiredFieldValidator>

         </td>
      </tr>
      <tr>
         <td></td>
         <td>
            <asp:Button id=Button1 
                 text="Validate" 
                 OnClick="ValidateBtn_Click" 
                 runat=server />
         </td>
         <td></td>
      </tr>
   </table>

</form>

</body>
</html>
   

Comentários

Use este controle para tornar um controle de entrada um campo obrigatório.Use this control to make an input control a required field. O controle de entrada falhará na validação se seu valor não for alterado da InitialValue propriedade quando o foco for perdido.The input control fails validation if its value does not change from the InitialValue property upon losing focus.

Vários validadores podem ser associados ao mesmo controle de entrada.Multiple validators can be associated with the same input control. Por exemplo, um RequiredFieldValidator pode ser usado para garantir a entrada para um controle, enquanto, ao mesmo tempo, um RangeValidator pode ser usado para garantir que a entrada esteja dentro de um intervalo de dados especificado.For example, a RequiredFieldValidator can be used to ensure input to a control, while at the same time a RangeValidator can be used to ensure that the input is within a specified data range.

Observação

Quando você usa o RequiredFieldValidator controle dentro de um UpdatePanel controle, certifique-se de que o controle de validador e o controle ao qual ele está associado estejam no mesmo painel.When you use the RequiredFieldValidator control inside an UpdatePanel control, make sure that the validator control and the control it is associated with are in the same panel. Para obter mais informações sobre como usar o UpdatePanel controle para atualizações de página parcial, consulte visão geral da renderização de página parcial.For more information about using the UpdatePanel control for partial-page updates, see Partial-Page Rendering Overview.

Para obter informações adicionais sobre controles de validação, consulte BaseValidator .For additional information on validation controls, see BaseValidator.

AcessibilidadeAccessibility

Para obter informações sobre como configurar esse controle para que ele gere marcação que esteja de acordo com os padrões de acessibilidade, consulte acessibilidade no Visual Studio e controles e acessibilidadeASP.net e ASP.net.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Construtores

RequiredFieldValidator()

Inicializa uma nova instância da classe RequiredFieldValidator.Initializes a new instance of RequiredFieldValidator class.

Propriedades

AccessKey

Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control.

(Herdado de Control)
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Herdado de Control)
AssociatedControlID

Não há suporte a esta propriedade.This property is not supported.

(Herdado de BaseValidator)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Herdado de WebControl)
BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.Gets or sets the background color of the Web server control.

(Herdado de WebControl)
BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.Gets or sets the border color of the Web control.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controle de servidor Web.Gets or sets the border style of the Web server control.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle de servidor Web.Gets or sets the border width of the Web server control.

(Herdado de WebControl)
ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property.

(Herdado de Control)
Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request.

(Herdado de Control)
Controls

Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Herdado de Control)
ControlStyle

Obtém o estilo de um controle de servidor Web.Gets the style of the Web server control. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is primarily used by control developers.

(Herdado de WebControl)
ControlToValidate

Obtém ou define o controle de entrada a ser validado.Gets or sets the input control to validate.

(Herdado de BaseValidator)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Herdado de WebControl)
DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Herdado de Control)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface.

(Herdado de Control)
Display

Obtém ou define o comportamento de exibição da mensagem de erro em um controle de validação.Gets or sets the display behavior of the error message in a validation control.

(Herdado de BaseValidator)
EnableClientScript

Obtém ou define um valor que indica se a validação do lado do cliente está habilitada.Gets or sets a value indicating whether client-side validation is enabled.

(Herdado de BaseValidator)
Enabled

Obtém ou define um valor que indica se o controle de validação está habilitado.Gets or sets a value that indicates whether the validation control is enabled.

(Herdado de BaseValidator)
EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.Gets or sets a value indicating whether themes apply to this control.

(Herdado de WebControl)
EnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Herdado de Control)
ErrorMessage

Obtém ou define o texto da mensagem de erro exibido em um controle ValidationSummary quando há falha na validação.Gets or sets the text for the error message displayed in a ValidationSummary control when validation fails.

(Herdado de BaseValidator)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Essa propriedade é somente leitura.This property is read-only.

(Herdado de Control)
Font

Obtém as propriedades de fonte associadas ao controle do servidor Web.Gets the font properties associated with the Web server control.

(Herdado de WebControl)
ForeColor

Obtém ou define a cor da mensagem exibida quando a validação falha.Gets or sets the color of the message displayed when validation fails.

(Herdado de BaseValidator)
HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.Gets a value indicating whether the control has attributes set.

(Herdado de WebControl)
HasChildViewState

Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Herdado de Control)
Height

Obtém ou define a altura do controle do servidor Web.Gets or sets the height of the Web server control.

(Herdado de WebControl)
ID

Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers.

(Herdado de Control)
InitialValue

Obtém ou define o valor inicial do controle de entrada associado.Gets or sets the initial value of the associated input control.

IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state.

(Herdado de Control)
IsEnabled

Obtém um valor que indica se o controle está habilitado.Gets a value indicating whether the control is enabled.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state.

(Herdado de Control)
IsUnobtrusive

Obtém um valor que indica se o controle gera JavaScript discreto.Gets a value that indicates whether the control generates unobtrusive JavaScript.

(Herdado de BaseValidator)
IsValid

Obtém ou define um valor que indica se o controle de entrada associado passa na validação.Gets or sets a value that indicates whether the associated input control passes validation.

(Herdado de BaseValidator)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control.

(Herdado de Control)
LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Herdado de Control)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy.

(Herdado de Control)
PropertiesValid

Obtém um valor que indica se o controle especificado pela propriedade ControlToValidate é um controle válido.Gets a value that indicates whether the control specified by the ControlToValidate property is a valid control.

(Herdado de BaseValidator)
RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Herdado de Control)
RenderUplevel

Obtém um valor que indica se o navegador do cliente dá suporte à renderização de "nível superior".Gets a value that indicates whether the client's browser supports "uplevel" rendering.

(Herdado de BaseValidator)
SetFocusOnError

Obtém ou define um valor que indica se o foco é definido para o controle especificado pela propriedade ControlToValidate quando a validação falhar.Gets or sets a value that indicates whether focus is set to the control specified by the ControlToValidate property when validation fails.

(Herdado de BaseValidator)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.Gets or sets the skin to apply to the control.

(Herdado de WebControl)
Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Herdado de Label)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.Gets or sets the tab index of the Web server control.

(Herdado de WebControl)
TagKey

Obtém a marca HTML usada para renderizar o controle Label.Gets the HTML tag that is used to render the Label control.

(Herdado de Label)
TagName

Obtém o nome da marca de controle.Gets the name of the control tag. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Herdado de Control)
Text

Obtém ou define o texto exibido no controle de validação quando a validação falha.Gets or sets the text displayed in the validation control when validation fails.

(Herdado de BaseValidator)
ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Herdado de WebControl)
UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Herdado de Control)
ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Herdado de Control)
ValidationGroup

Obtém ou define o nome do grupo de validação ao qual esse controle de validação pertence.Gets or sets the name of the validation group to which this validation control belongs.

(Herdado de BaseValidator)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Herdado de Control)
Width

Obtém ou define a largura do controle de servidor Web.Gets or sets the width of the Web server control.

(Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona os estilos e atributos HTML que precisam ser renderizados para o controle para o objeto HtmlTextWriter especificado.Adds the HTML attributes and styles that need to be rendered for the control to the specified HtmlTextWriter object.

AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle de que um elemento foi analisado e adiciona o elemento ao controle Label.Notifies the control that an element was parsed and adds the element to the Label control.

(Herdado de Label)
ApplyStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controles.This method is primarily used by control developers.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties defined in the page style sheet to the control.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Herdado de Control)
CheckControlValidationProperty(String, String)

Verifica se o controle especificado está na página e contém propriedades de validação.Verifies whether the specified control is on the page and contains validation properties.

(Herdado de BaseValidator)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.Sets the cached ClientID value to null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Herdado de Control)
ControlPropertiesValid()

Determina se o controle especificado pela propriedade ControlToValidate é um controle válido.Determines whether the control specified by the ControlToValidate property is a valid control.

(Herdado de BaseValidator)
CopyBaseAttributes(WebControl)

Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
CreateChildControls()

Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Herdado de Control)
CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Herdado de Control)
CreateControlStyle()

Cria o objeto de estilo que é usado internamente pela classe WebControl para implementar todas as propriedades relacionadas a estilo.Creates the style object that is used internally by the WebControl class to implement all style related properties. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
DataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.Binds a data source to the invoked server control and all its child controls.

(Herdado de Control)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls.

(Herdado de Control)
DetermineRenderUplevel()

Determina se o controle de validação pode realizar a validação do lado do cliente.Determines whether the validation control can perform client-side validation.

(Herdado de BaseValidator)
Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls.

(Herdado de Control)
EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
EvaluateIsValid()

Chamado durante o estágio de validação quando o ASP.NET processa um formulário da Web.Called during the validation stage when ASP.NET processes a Web Form.

FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.Searches the current naming container for a server control with the specified id parameter.

(Herdado de Control)
FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Você não deve substituir esta versão do método FindControl.You should not override this version of the FindControl method.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.Sets input focus to a control.

(Herdado de Control)
GetControlRenderID(String)

Obtém a ID do cliente do controle especificado.Gets the client ID of the specified control.

(Herdado de BaseValidator)
GetControlValidationValue(String)

Obtém o valor associado ao controle de entrada especificado.Gets the value associated with the specified input control.

(Herdado de BaseValidator)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.Gets design-time data for a control.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls.

(Herdado de Control)
IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content.

(Herdado de Control)
LoadControlState(Object)

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Herdado de Control)
LoadViewState(Object)

Carrega o estado salvo anteriormente para o controle.Loads the previously saved state for the control.

(Herdado de Label)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MergeStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Herdado de Control)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.Raises the DataBinding event.

(Herdado de Control)
OnInit(EventArgs)

Aciona o evento Init.Raises the Init event.

(Herdado de BaseValidator)
OnLoad(EventArgs)

Aciona o evento Load.Raises the Load event.

(Herdado de Control)
OnPreRender(EventArgs)

Aciona o evento PreRender.Raises the PreRender event.

(Herdado de BaseValidator)
OnUnload(EventArgs)

Aciona o evento Unload.Raises the Unload event.

(Herdado de BaseValidator)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent.

(Herdado de Control)
RegisterValidatorCommonScript()

Registra o código na página para a validação do lado do cliente.Registers code on the page for client-side validation.

(Herdado de BaseValidator)
RegisterValidatorDeclaration()

Registra uma declaração de matriz ECMAScript usando o nome da matriz Page_Validators.Registers an ECMAScript array declaration using the array name Page_Validators.

(Herdado de BaseValidator)
RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Herdado de Control)
Render(HtmlTextWriter)

Exibe o controle no cliente.Displays the control on the client.

(Herdado de BaseValidator)
RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado.Renders the HTML opening tag of the control to the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do Label no gravador especificado.Renders the contents of the Label into the specified writer.

(Herdado de Label)
RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado.Renders the HTML closing tag of the control into the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client.

(Herdado de Control)
SaveControlState()

Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Herdado de Control)
SaveViewState()

Salva qualquer estado que foi modificado depois que o método TrackViewState() foi invocado.Saves any state that was modified after the TrackViewState() method was invoked.

(Herdado de WebControl)
SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.Sets design-time data for a control.

(Herdado de Control)
SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.Assigns an event handler delegate to render the server control and its content into its parent control.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
TrackViewState()

Faz com que o controle acompanhe as alterações a seu estado de exibição para que eles possam ser armazenados na propriedade ViewState do objeto.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Herdado de WebControl)
Validate()

Executa validação no controle de entrada associado e atualiza a propriedade IsValid.Performs validation on the associated input control and updates the IsValid property.

(Herdado de BaseValidator)

Eventos

DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source.

(Herdado de Control)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Herdado de Control)
Load

Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object.

(Herdado de Control)
PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering.

(Herdado de Control)
Unload

Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.Gets an attribute of the Web control with the specified name.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controle da Web para o nome e o valor especificados.Sets an attribute of the Web control to the specified name and value.

(Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.For a description of this member, see ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().For a description of this member, see GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.For a description of this member, see UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.For a description of this member, see DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.For a description of this member, see HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.For a description of this member, see Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.For a description of this member, see HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Herdado de Control)

Métodos de Extensão

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control.

Aplica-se a

Confira também