TextBox Classe

Definição

Exibe um controle de caixa de texto para a entrada do usuário.Displays a text box control for user input.

public ref class TextBox : System::Web::UI::WebControls::WebControl, System::Web::UI::IEditableTextControl, System::Web::UI::IPostBackDataHandler
[System.Web.UI.ControlValueProperty("Text")]
[System.Web.UI.ValidationProperty("Text")]
public class TextBox : System.Web.UI.WebControls.WebControl, System.Web.UI.IEditableTextControl, System.Web.UI.IPostBackDataHandler
type TextBox = class
    inherit WebControl
    interface IPostBackDataHandler
    interface IEditableTextControl
    interface ITextControl
Public Class TextBox
Inherits WebControl
Implements IEditableTextControl, IPostBackDataHandler
Herança
Atributos
Implementações

Exemplos

Um projeto de site do Visual Studio com código-fonte está disponível para acompanhar este tópico: Baixar.A Visual Studio Web site project with source code is available to accompany this topic: Download.

O exemplo de código a seguir demonstra como usar o controle TextBox para obter a entrada do usuário.The following code example demonstrates how to use the TextBox control to get user input. Quando o usuário clica no botão Adicionar , a soma dos valores inseridos nas caixas de texto é exibida.When the user clicks the Add button, the sum of the values entered in the text boxes is displayed.

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>  
<html>   
  
<head>  
    <title>TextBox Example</title>  
    <script runat="server">  
      protected void AddButton_Click(Object sender, EventArgs e)  
      {  
         int Answer;  
         Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);  
         AnswerMessage.Text = Answer.ToString();  
      }  
    </script>  
</head>  
<body>  
  <form id="form1" runat="server">  
    <h3> TextBox Example </h3>  
    <p>  
        <asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        +  
        <asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        =  
        <asp:Label ID="AnswerMessage" runat="server"/>  
    </p>  
    <p>  
        <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/>  
    </p>  
    <p>  
        <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"  
             runat="server"/>  
        <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"      
             runat="server"/>  
    </p>  
  </form>  
</body>  
</html>  
<%@ Page Language="vb" AutoEventWireup="false" %>  
  
<!DOCTYPE html>  
<html>   
  
<head>  
    <title>TextBox Example</title>  
    <script runat="server">  
        Protected Sub AddButton_Click(sender As Object, e As EventArgs)  
            Dim Answer As Integer  
            Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)  
            AnswerMessage.Text = Answer.ToString()  
        End Sub  
    </script>  
</head>  
<body>  
  <form id="form1" runat="server">  
    <h3> TextBox Example </h3>  
    <p>  
        <asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        +  
        <asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        =  
        <asp:Label ID="AnswerMessage" runat="server"/>  
    </p>  
    <p>  
        <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/>  
    </p>  
    <p>  
        <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"  
             runat="server"/>  
        <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"      
             runat="server"/>  
    </p>  
  </form>  
</body>  
</html>  

Comentários

Neste tópico:In this topic:

IntroduçãoIntroduction

O controle de servidor TextBox é um controle de entrada que permite ao usuário inserir texto.The TextBox server control is an input control that lets the user enter text. Por padrão, a propriedade TextMode do controle é definida como TextBoxMode.SingleLine, que exibe uma caixa de texto de linha única.By default, the TextMode property of the control is set to TextBoxMode.SingleLine, which displays a single-line text box. No entanto, você também pode usar o controle TextBox para exibir uma caixa de texto de várias linhas ou uma caixa de texto que mascara a entrada do usuário alterando o valor da propriedade TextMode para TextBoxMode.MultiLine ou TextBoxMode.Password, respectivamente.However, you can also use the TextBox control to display a multiline text box or a text box that masks user input by changing the value of the TextMode property to TextBoxMode.MultiLine or TextBoxMode.Password, respectively. O texto exibido no controle TextBox é especificado ou determinado usando a propriedade Text.The text displayed in the TextBox control is specified or determined by using the Text property.

O controle TextBox contém várias propriedades que permitem controlar a aparência do controle.The TextBox control contains several properties that allow you to control the appearance of the control. A largura de exibição da caixa de texto, em caracteres, é determinada por sua propriedade Columns.The display width of the text box, in characters, is determined by its Columns property. Se o controle TextBox for uma caixa de texto de várias linhas, o número de linhas exibidas será determinado pela propriedade Rows.If the TextBox control is a multiline text box, the number of rows it displays is determined by the Rows property. Para exibir o texto que encapsula dentro do controle TextBox, defina a propriedade Wrap como true.To display text that wraps within the TextBox control, set the Wrap property to true.

Você também pode especificar como os dados são inseridos no controle TextBox definindo algumas propriedades.You can also specify how data is entered in the TextBox control by setting a few properties. Para impedir que o texto exibido no controle seja modificado, defina a propriedade ReadOnly como true.To prevent the text displayed in the control from being modified, set the ReadOnly property to true. Se você quiser limitar a entrada do usuário a um número especificado de caracteres, defina a propriedade MaxLength.If you want to limit the user input to a specified number of characters, set the MaxLength property.

Para obter uma lista de valores de propriedade inicial para uma instância do TextBox, consulte o Construtor TextBox.For a list of initial property values for an instance of TextBox, see the TextBox constructor.

Cuidado

Esse controle pode ser usado para aceitar a entrada do usuário, que pode incluir script de cliente mal-intencionado.This control can be used to accept user input, which might include malicious client script. Verifique todas as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo em seu aplicativo.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. Você pode usar controles de validação para verificar a entrada do usuário antes de exibir o texto de entrada em um controle.You can use validation controls to verify user input before displaying the input text in a control. O ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear o script e o HTML na entrada do usuário.ASP.NET provides an input request validation feature to block script and HTML in user input. Para obter mais informações, consulte protegendo controles padrão, [How para: Proteja-se contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres @ no__t-0 e validando entrada do usuário em páginas da Web do ASP.net.For more information, see Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Validating User Input in ASP.NET Web Pages.

Sintaxe declarativaDeclarative Syntax

<asp:TextBox  
    AccessKey="string"  
    AutoCompleteType="None|Disabled|Cellular|Company|Department|  
        DisplayName|Email|FirstName|Gender|HomeCity|HomeCountryRegion|  
        HomeFax|HomePhone|HomeState|HomeStreetAddress|HomeZipCode|  
        Homepage|JobTitle|LastName|MiddleName|Notes|Office|Pager|  
        BusinessCity|BusinessCountryRegion|BusinessFax|BusinessPhone|  
        BusinessState|BusinessStreetAddress|BusinessUrl|  
        BusinessZipCode|Search"  
    AutoPostBack="True|False"  
    BackColor="color name|#dddddd"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    CausesValidation="True|False"  
    Columns="integer"  
    CssClass="string"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    Font-Bold="True|False"  
    Font-Italic="True|False"  
    Font-Names="string"  
    Font-Overline="True|False"  
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|  
        Large|X-Large|XX-Large"  
    Font-Strikeout="True|False"  
    Font-Underline="True|False"  
    ForeColor="color name|#dddddd"  
    Height="size"  
    ID="string"  
    MaxLength="integer"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnTextChanged="TextChanged event handler"  
    OnUnload="Unload event handler"  
    ReadOnly="True|False"  
    Rows="integer"  
    runat="server"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    Text="string"  
    TextMode="SingleLine|MultiLine|Password"  
    ToolTip="string"  
    ValidationGroup="string"  
    Visible="True|False"  
    Width="size"  
    Wrap="True|False"  
/>  

Construtores

TextBox()

Inicializa uma nova instância da classe TextBox.Initializes a new instance of the TextBox 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)
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)
AutoCompleteType

Obtém ou define um valor que indica o comportamento de Preenchimento Automático do controle TextBox.Gets or sets a value that indicates the AutoComplete behavior of the TextBox control.

AutoPostBack

Obtém ou define um valor que indica se ocorre um postback automático para o servidor quando o controle TextBox perde o foco.Gets or sets a value that indicates whether an automatic postback to the server occurs when the TextBox control loses focus.

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

Obtém ou define um valor que indica se a validação é executada quando o controle TextBox está definido para validar quando ocorrer um postback.Gets or sets a value indicating whether validation is performed when the TextBox control is set to validate when a postback occurs.

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

Obtém ou define a largura da exibição da caixa de texto em caracteres.Gets or sets the display width of the text box in characters.

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

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.Gets or sets a value indicating whether the Web server control is enabled.

(Herdado de WebControl)
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)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Esta propriedade é somente para 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 de primeiro plano (normalmente a cor do texto) do controle de servidor Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Herdado de WebControl)
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)
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)
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)
MaxLength

Obtém ou define o número máximo de caracteres permitidos na caixa de texto.Gets or sets the maximum number of characters allowed in the text box.

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

Obtém ou define um valor que indica se o conteúdo do controle TextBox pode ser alterado.Gets or sets a value indicating whether the contents of the TextBox control can be changed.

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

Obtém ou define o número de linhas exibidas em uma caixa de texto multilinha.Gets or sets the number of rows displayed in a multiline text box.

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 WebControl)
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 para o controle de caixa de texto.Gets the HTML tag for the text box control. Esta propriedade é protegida.This property is protected.

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 conteúdo do texto do controle TextBox.Gets or sets the text content of the TextBox control.

TextMode

Obtém ou define o modo de comportamento (por exemplo, uma linha, multilinha ou senha) do controle TextBox.Gets or sets the behavior mode (such as, single-line, multiline, or password) of the TextBox control.

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 grupo de controles para os quais o controle TextBox aciona a validação quando posta de volta no servidor.Gets or sets the group of controls for which the TextBox control causes validation when it posts back to the server.

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

Obtém ou define um valor que indica se o conteúdo de texto é quebrado em uma caixa de texto de várias linhas.Gets or sets a value indicating whether the text content wraps within a multiline text box.

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizados à instância HtmlTextWriter especificada.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter instance.

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)

Substituído para permitir que somente controles literais sejam adicionados como a propriedade Text.Overridden to allow only literal controls to be added as the Text property.

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)
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)
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)
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)
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)
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)
LoadPostData(String, NameValueCollection)

Processa os dados de postback para o controle TextBox.Processes the postback data for the TextBox control.

LoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o método SaveViewState().Restores view-state information from a previous request that was saved with the SaveViewState() method.

(Herdado de WebControl)
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 Control)
OnLoad(EventArgs)

Aciona o evento Load.Raises the Load event.

(Herdado de Control)
OnPreRender(EventArgs)

Registra o script de cliente para gerar eventos de postback antes da renderização no cliente, se AutoPostBack é true.Registers client script for generating postback events prior to rendering on the client, if AutoPostBack is true.

OnTextChanged(EventArgs)

Aciona o evento TextChanged.Raises the TextChanged event. Permite manipular o evento diretamente.This allows you to handle the event directly.

OnUnload(EventArgs)

Aciona o evento Unload.Raises the Unload event.

(Herdado de Control)
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)
RaisePostDataChangedEvent()

Invoca o método OnTextChanged(EventArgs) quando os dados publicados para o controle TextBox foram alterados.Invokes the OnTextChanged(EventArgs) method when the posted data for the TextBox control has changed.

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)

Renderiza o controle TextBox no objeto HtmlTextWriter especificado.Renders the TextBox control to the specified HtmlTextWriter object.

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 de filhos de um controle de servidor a 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 controle no gravador especificado.Renders the contents 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)
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 as alterações no estado de exibição da caixa de texto desde a hora em que a página foi postada de volta no servidor.Saves the changes to the text box view state since the time the page was posted back to the server.

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 em seu estado de exibição para que elas possam ser armazenadas 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)

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

Ocorre quando o conteúdo da caixa de texto é alterado entre as postagens no servidor.Occurs when the content of the text box changes between posts to the server.

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, consulte ControlBuilder.For a description of this member, see ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

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

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

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

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

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

(Herdado de Control)
IControlDesignerAccessor.UserData

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

(Herdado de Control)
IDataBindingsAccessor.DataBindings

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

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

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

(Herdado de Control)
IExpressionsAccessor.Expressions

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

(Herdado de Control)
IExpressionsAccessor.HasExpressions

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

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

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

(Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Carrega o conteúdo postado da caixa de texto se ele for diferente da última postagem.Loads the posted text box content if it is different from the last posting.

IPostBackDataHandler.RaisePostDataChangedEvent()

Invoca o método OnTextChanged(EventArgs) sempre que os dados postados da caixa de texto forem alterados.Invokes the OnTextChanged(EventArgs) method whenever posted data for the text box has changed.

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

Veja também