TextBox Klasa

Definicja

Wyświetla kontrolkę pole tekstowe do wprowadzania danych przez użytkownika.Displays a text box control for user input.

public ref class TextBox : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackDataHandler
public ref class TextBox : System::Web::UI::WebControls::WebControl, System::Web::UI::IEditableTextControl, System::Web::UI::IPostBackDataHandler
[System.Web.UI.ValidationProperty("Text")]
public class TextBox : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackDataHandler
[System.Web.UI.ValidationProperty("Text")]
[System.Web.UI.ControlValueProperty("Text")]
public class TextBox : System.Web.UI.WebControls.WebControl, System.Web.UI.IEditableTextControl, System.Web.UI.IPostBackDataHandler
[<System.Web.UI.ValidationProperty("Text")>]
type TextBox = class
    inherit WebControl
    interface IPostBackDataHandler
[<System.Web.UI.ValidationProperty("Text")>]
[<System.Web.UI.ControlValueProperty("Text")>]
type TextBox = class
    inherit WebControl
    interface IPostBackDataHandler
    interface IEditableTextControl
    interface ITextControl
Public Class TextBox
Inherits WebControl
Implements IPostBackDataHandler
Public Class TextBox
Inherits WebControl
Implements IEditableTextControl, IPostBackDataHandler
Dziedziczenie
Atrybuty
Implementuje

Przykłady

Projekt witryny sieci Web programu Visual Studio z kodem źródłowym jest dostępny do załączenia do tego tematu: Pobierz.A Visual Studio Web site project with source code is available to accompany this topic: Download.

Poniższy przykład kodu demonstruje, jak używać TextBox kontrolki do pobierania danych wejściowych użytkownika.The following code example demonstrates how to use the TextBox control to get user input. Gdy użytkownik kliknie przycisk Dodaj , zostanie wyświetlona suma wartości wprowadzonych w polach tekstowych.When the user clicks the Add button, the sum of the values entered in the text boxes is displayed.

Ważne

Ten przykład zawiera pole tekstowe akceptujące dane wejściowe użytkownika, które jest potencjalnym zagrożeniem bezpieczeństwa.This example has a text box that accepts user input, which is a potential security threat. Domyślnie strony sieci Web ASP.NET sprawdzają, czy dane wejściowe użytkownika nie obejmują elementów skryptu ani HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach.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>

Uwagi

W tym temacie:In this topic:

WprowadzenieIntroduction

TextBoxFormant serwera to kontrolka wejściowa, która umożliwia użytkownikowi wprowadzanie tekstu.The TextBox server control is an input control that lets the user enter text. Domyślnie TextMode Właściwość kontrolki jest ustawiona na TextBoxMode.SingleLine , która wyświetla jednowierszowe pole tekstowe.By default, the TextMode property of the control is set to TextBoxMode.SingleLine, which displays a single-line text box. Można jednak również użyć TextBox kontrolki do wyświetlania wielowierszowego pola tekstowego lub pola tekstowego, które maskuje dane wprowadzane przez użytkownika, zmieniając wartość TextMode właściwości na TextBoxMode.MultiLine lub TextBoxMode.Password , odpowiednio.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. Tekst wyświetlany w TextBox kontrolce jest określany lub określany za pomocą Text właściwości.The text displayed in the TextBox control is specified or determined by using the Text property.

TextBoxKontrolka zawiera kilka właściwości, które umożliwiają kontrolowanie wyglądu kontrolki.The TextBox control contains several properties that allow you to control the appearance of the control. Szerokość wyświetlania pola tekstowego (w znakach) jest określana na podstawie jej Columns właściwości.The display width of the text box, in characters, is determined by its Columns property. Jeśli TextBox formant jest wielowierszowym polem tekstowym, Liczba wyświetlanych wierszy jest określana przez Rows Właściwość.If the TextBox control is a multiline text box, the number of rows it displays is determined by the Rows property. Aby wyświetlić tekst, który jest zawijany w TextBox kontrolce, ustaw Wrap Właściwość na true .To display text that wraps within the TextBox control, set the Wrap property to true.

Możesz również określić sposób wprowadzania danych w TextBox kontrolce, ustawiając kilka właściwości.You can also specify how data is entered in the TextBox control by setting a few properties. Aby zapobiec modyfikowaniu tekstu wyświetlanego w kontrolce, ustaw ReadOnly Właściwość na true .To prevent the text displayed in the control from being modified, set the ReadOnly property to true. Jeśli chcesz ograniczyć dane wejściowe użytkownika do określonej liczby znaków, ustaw MaxLength Właściwość.If you want to limit the user input to a specified number of characters, set the MaxLength property.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia TextBox , zobacz TextBox Konstruktor.For a list of initial property values for an instance of TextBox, see the TextBox constructor.

Przestroga

Ta kontrolka może służyć do akceptowania danych wejściowych użytkownika, co może obejmować złośliwy skrypt klienta.This control can be used to accept user input, which might include malicious client script. Sprawdź wszystkie informacje wysyłane z klienta pod kątem skryptu wykonywalnego, instrukcji SQL lub innego kodu przed wyświetleniem go w aplikacji.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. Możesz użyć kontrolek walidacji do zweryfikowania danych wejściowych użytkownika przed wyświetleniem tekstu wejściowego w kontrolce.You can use validation controls to verify user input before displaying the input text in a control. ASP.NET udostępnia funkcję walidacji żądania wejścia, aby blokować skrypt i kod HTML w danych wejściowych użytkownika.ASP.NET provides an input request validation feature to block script and HTML in user input. Aby uzyskać więcej informacji, zobacz Zabezpieczanie standardowych kontrolek, jak: Ochrona przed programami wykorzystującymi luki w zabezpieczeniach w aplikacji sieci Web przez zastosowanie kodowania HTML do ciągówi Sprawdzanie poprawności danych wejściowych użytkownika na stronach sieci Web 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.

Składnia deklaracyjnaDeclarative 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"
/>

Konstruktory

TextBox()

Inicjuje nowe wystąpienie klasy TextBox.Initializes a new instance of the TextBox class.

Właściwości

AccessKey

Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontrolki serwera sieci Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Odziedziczone po WebControl)
Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.Gets the browser-specific adapter for the control.

(Odziedziczone po Control)
AppRelativeTemplateSourceDirectory

Pobiera lub ustawia katalog wirtualny względem aplikacji Page lub UserControl obiekt, który zawiera tę kontrolkę.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Odziedziczone po Control)
Attributes

Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Odziedziczone po WebControl)
AutoCompleteType

Pobiera lub ustawia wartość wskazującą zachowanie autouzupełniania TextBox formantu.Gets or sets a value that indicates the AutoComplete behavior of the TextBox control.

AutoPostBack

Pobiera lub ustawia wartość wskazującą, czy automatyczne ogłaszanie zwrotne na serwerze występuje, gdy TextBox kontrolka utraci fokus.Gets or sets a value that indicates whether an automatic postback to the server occurs when the TextBox control loses focus.

BackColor

Pobiera lub ustawia kolor tła kontrolki serwera sieci Web.Gets or sets the background color of the Web server control.

(Odziedziczone po WebControl)
BindingContainer

Pobiera formant, który zawiera powiązanie danych tego formantu.Gets the control that contains this control's data binding.

(Odziedziczone po Control)
BorderColor

Pobiera lub ustawia kolor obramowania kontrolki sieci Web.Gets or sets the border color of the Web control.

(Odziedziczone po WebControl)
BorderStyle

Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web.Gets or sets the border style of the Web server control.

(Odziedziczone po WebControl)
BorderWidth

Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web.Gets or sets the border width of the Web server control.

(Odziedziczone po WebControl)
CausesValidation

Pobiera lub ustawia wartość wskazującą, czy Walidacja jest wykonywana, gdy TextBox kontrolka jest ustawiona do walidacji w przypadku wystąpienia zwrotnego.Gets or sets a value indicating whether validation is performed when the TextBox control is set to validate when a postback occurs.

ChildControlsCreated

Pobiera wartość wskazującą, czy zostały utworzone formanty podrzędne kontrolki serwera.Gets a value that indicates whether the server control's child controls have been created.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator formantu dla znacznika HTML, który jest generowany przez ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Odziedziczone po Control)
ClientIDMode

Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Odziedziczone po Control)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora używany we ClientID właściwości.Gets a character value representing the separator character used in the ClientID property.

(Odziedziczone po Control)
Columns

Pobiera lub ustawia szerokość wyświetlania pola tekstowego w znakach.Gets or sets the display width of the text box in characters.

Context

Pobiera HttpContext obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.Gets the HttpContext object associated with the server control for the current Web request.

(Odziedziczone po Control)
Controls

Pobiera ControlCollection obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Odziedziczone po Control)
ControlStyle

Pobiera styl kontrolki serwera sieci Web.Gets the style of the Web server control. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebControl)
ControlStyleCreated

Pobiera wartość wskazującą, czy Style obiekt został utworzony dla ControlStyle właściwości.Gets a value indicating whether a Style object has been created for the ControlStyle property. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is primarily used by control developers.

(Odziedziczone po WebControl)
CssClass

Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez formant serwera sieci Web na kliencie.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Odziedziczone po WebControl)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataItemContainer .Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Odziedziczone po Control)
DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataKeysControl .Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Odziedziczone po Control)
DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.Gets a value indicating whether a control is being used on a design surface.

(Odziedziczone po Control)
Enabled

Pobiera lub ustawia wartość wskazującą, czy formant serwera sieci Web jest włączony.Gets or sets a value indicating whether the Web server control is enabled.

(Odziedziczone po WebControl)
EnableTheming

Pobiera lub ustawia wartość wskazującą, czy motywy stosują się do tej kontrolki.Gets or sets a value indicating whether themes apply to this control.

(Odziedziczone po WebControl)
EnableViewState

Pobiera lub ustawia wartość wskazującą, czy formant serwera utrzymuje stan widoku, oraz stan widoku wszystkich formantów podrzędnych, które zawiera, do żądającego klienta.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.

(Odziedziczone po Control)
Events

Pobiera listę delegatów obsługi zdarzeń dla formantu.Gets a list of event handler delegates for the control. Ta właściwość jest tylko do odczytu.This property is read-only.

(Odziedziczone po Control)
Font

Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web.Gets the font properties associated with the Web server control.

(Odziedziczone po WebControl)
ForeColor

Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Odziedziczone po WebControl)
HasAttributes

Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty.Gets a value indicating whether the control has attributes set.

(Odziedziczone po WebControl)
HasChildViewState

Pobiera wartość wskazującą, czy bieżące kontrolki formantu serwera mają jakiekolwiek zapisane ustawienia stanu widoku.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Odziedziczone po Control)
Height

Pobiera lub ustawia wysokość kontrolki serwera sieci Web.Gets or sets the height of the Web server control.

(Odziedziczone po WebControl)
ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwerowej.Gets or sets the programmatic identifier assigned to the server control.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontroli.Gets the character used to separate control identifiers.

(Odziedziczone po Control)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tym formancie mają stan kontroli.Gets a value indicating whether controls contained within this control have control state.

(Odziedziczone po Control)
IsEnabled

Pobiera wartość wskazującą, czy kontrolka jest włączona.Gets a value indicating whether the control is enabled.

(Odziedziczone po WebControl)
IsTrackingViewState

Pobiera wartość wskazującą, czy formant serwera zapisuje zmiany w stanie widoku.Gets a value that indicates whether the server control is saving changes to its view state.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy stan widoku jest włączony dla tego formantu.Gets a value indicating whether view state is enabled for this control.

(Odziedziczone po Control)
LoadViewStateByID

Pobiera wartość wskazującą, czy formant uczestniczy w ładowaniu stanu widoku przez ID zamianę na indeks.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Odziedziczone po Control)
MaxLength

Pobiera lub ustawia maksymalną liczbę znaków dozwoloną w polu tekstowym.Gets or sets the maximum number of characters allowed in the text box.

NamingContainer

Pobiera odwołanie do kontenera nazw kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera z tą samą ID wartością właściwości.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.

(Odziedziczone po Control)
Page

Pobiera odwołanie do Page wystąpienia, które zawiera formant serwera.Gets a reference to the Page instance that contains the server control.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii formantów strony.Gets a reference to the server control's parent control in the page control hierarchy.

(Odziedziczone po Control)
ReadOnly

Pobiera lub ustawia wartość wskazującą, czy zawartość TextBox kontrolki może być zmieniana.Gets or sets a value indicating whether the contents of the TextBox control can be changed.

RenderingCompatibility

Pobiera wartość określającą ASP.NET wersję, która będzie zgodna z językiem HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Odziedziczone po Control)
Rows

Pobiera lub ustawia liczbę wierszy wyświetlanych w wielowierszowym polu tekstowym.Gets or sets the number of rows displayed in a multiline text box.

Site

Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę, gdy jest renderowany na powierzchni projektowej.Gets information about the container that hosts the current control when rendered on a design surface.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórkę, która ma zostać zastosowana do kontrolki.Gets or sets the skin to apply to the control.

(Odziedziczone po WebControl)
Style

Pobiera kolekcję atrybutów tekstu, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Odziedziczone po WebControl)
SupportsDisabledAttribute

Pobiera wartość wskazującą, czy formant powinien ustawić disabled atrybut renderowanego elementu HTML na "Disabled", gdy właściwość kontrolki IsEnabled ma wartość 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.

(Odziedziczone po WebControl)
TabIndex

Pobiera lub ustawia indeks karty dla kontrolki serwer sieci Web.Gets or sets the tab index of the Web server control.

(Odziedziczone po WebControl)
TagKey

Pobiera tag HTML dla kontrolki pole tekstowe.Gets the HTML tag for the text box control. Ta właściwość jest chroniona.This property is protected.

TagName

Pobiera nazwę tagu kontrolki.Gets the name of the control tag. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebControl)
TemplateControl

Pobiera lub ustawia odwołanie do szablonu, który zawiera tę kontrolkę.Gets or sets a reference to the template that contains this control.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny Page lub zawierający UserControl bieżącą kontrolkę serwerową.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Odziedziczone po Control)
Text

Pobiera lub ustawia zawartość tekstową TextBox formantu.Gets or sets the text content of the TextBox control.

TextMode

Pobiera lub ustawia tryb zachowania (taki jak pojedynczy wiersz, Wielowierszowy lub hasło) TextBox formantu.Gets or sets the behavior mode (such as, single-line, multiline, or password) of the TextBox control.

ToolTip

Pobiera lub ustawia tekst wyświetlany, gdy wskaźnik myszy znajduje się nad kontrolką serwera sieci Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Odziedziczone po WebControl)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator dla kontrolki serwerowej.Gets the unique, hierarchically qualified identifier for the server control.

(Odziedziczone po Control)
ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy formant sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Odziedziczone po Control)
ValidationGroup

Pobiera lub ustawia grupę kontrolek, dla których TextBox formant powoduje uruchomienie walidacji, gdy odsyła na serwer.Gets or sets the group of controls for which the TextBox control causes validation when it posts back to the server.

ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach na tej samej stronie.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.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy w StateBag obiekcie nie jest rozróżniana wielkość liter.Gets a value that indicates whether the StateBag object is case-insensitive.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb widoku stanu tego formantu.Gets or sets the view-state mode of this control.

(Odziedziczone po Control)
Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Odziedziczone po Control)
Width

Pobiera lub ustawia szerokość kontrolki serwera sieci Web.Gets or sets the width of the Web server control.

(Odziedziczone po WebControl)
Wrap

Pobiera lub ustawia wartość wskazującą, czy zawartość tekstowa jest zawijana w wielowierszowym polu tekstowym.Gets or sets a value indicating whether the text content wraps within a multiline text box.

Metody

AddAttributesToRender(HtmlTextWriter)

Dodaje atrybuty HTML i style, które muszą być renderowane do określonego HtmlTextWriter wystąpienia.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter instance.

AddedControl(Control, Int32)

Wywołuje się po dodaniu formantu podrzędnego do Controls kolekcji Control obiektu.Called after a child control is added to the Controls collection of the Control object.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Przesłonięty, aby zezwalać na dodawanie tylko kontrolek literału jako Text właściwości.Overridden to allow only literal controls to be added as the Text property.

ApplyStyle(Style)

Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki sieci Web, zastępując wszelkie istniejące elementy stylu formantu.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Ta metoda jest używana głównie przez deweloperów kontroli.This method is primarily used by control developers.

(Odziedziczone po WebControl)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.Applies the style properties defined in the page style sheet to the control.

(Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie danych renderowania w czasie projektowania.Begins design-time tracing of rendering data.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o formancie serwera i dostarcza go do Trace właściwości, która będzie wyświetlana po włączeniu śledzenia dla strony.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość w pamięci podręcznej ClientID na null .Sets the cached ClientID value to null.

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie formantu dla kontrolek podrzędnych kontrolki serwerowej.Deletes the control-state information for the server control's child controls.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i kontroli dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state and control-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

Ustawia ClientIDMode Właściwość bieżącego wystąpienia kontrolki i wszystkich formantów podrzędnych na Inherit .Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Odziedziczone po Control)
CopyBaseAttributes(WebControl)

Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z której ta metoda jest wywoływana.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. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
CreateChildControls()

Wywoływane przez platformę strony ASP.NET w celu powiadomienia formantów serwera, które używają implementacji opartej na kompozycjach, do tworzenia wszelkich formantów podrzędnych, które zawierają w przygotowaniu do ponownego ogłaszania lub renderowania.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.

(Odziedziczone po Control)
CreateControlCollection()

Tworzy nowy ControlCollection obiekt do przechowywania formantów podrzędnych (zarówno literału, jak i serwera) formantu serwera.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Odziedziczone po Control)
CreateControlStyle()

Tworzy obiekt Style, który jest używany wewnętrznie przez WebControl klasę do implementowania wszystkich właściwości związanych z stylem.Creates the style object that is used internally by the WebControl class to implement all style related properties. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
DataBind()

Tworzy powiązanie źródła danych z wywołaną kontrolką serwera i wszystkimi jego kontrolkami podrzędnymi.Binds a data source to the invoked server control and all its child controls.

(Odziedziczone po Control)
DataBind(Boolean)

Tworzy powiązanie źródła danych z wywoływanym formantem serwera i wszystkimi jego kontrolkami podrzędnymi z opcją podniesienia poziomu DataBinding zdarzenia.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Odziedziczone po Control)
DataBindChildren()

Tworzy powiązanie źródła danych z kontrolkami podrzędnymi formantu serwera.Binds a data source to the server control's child controls.

(Odziedziczone po Control)
Dispose()

Umożliwia formantowi serwera przeprowadzenie końcowego oczyszczania przed jego zwolnieniem z pamięci.Enables a server control to perform final clean up before it is released from memory.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Przerywa śledzenie danych renderowania w czasie projektowania.Ends design-time tracing of rendering data.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy formant serwera zawiera kontrolki podrzędne.Determines whether the server control contains child controls. Jeśli tak nie jest, tworzy kontrolki podrzędne.If it does not, it creates child controls.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator dla kontrolek, które nie mają przypisanego identyfikatora.Creates an identifier for controls that do not have an identifier assigned.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określonym id parametrem.Searches the current naming container for a server control with the specified id parameter.

(Odziedziczone po Control)
FindControl(String, Int32)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określoną id i liczbą całkowitą, która jest określona w pathOffset parametrze, który ułatwia wyszukiwanie.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. Nie należy przesłaniać tej wersji FindControl metody.You should not override this version of the FindControl method.

(Odziedziczone po Control)
Focus()

Ustawia fokus wprowadzania dla kontrolki.Sets input focus to a control.

(Odziedziczone po Control)
GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.Gets design-time data for a control.

(Odziedziczone po Control)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca przedznaczoną część UniqueID właściwości określonej kontrolki.Returns the prefixed portion of the UniqueID property of the specified control.

(Odziedziczone po Control)
HasControls()

Określa, czy formant serwera zawiera wszystkie kontrolki podrzędne.Determines if the server control contains any child controls.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą czy zdarzenia są rejestrowane dla kontrolki lub wszelkich formantów podrzędnych.Returns a value indicating whether events are registered for the control or any child controls.

(Odziedziczone po Control)
IsLiteralContent()

Określa, czy formant serwera przechowuje tylko zawartość literału.Determines if the server control holds only literal content.

(Odziedziczone po Control)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez SaveControlState() metodę.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Odziedziczone po Control)
LoadPostData(String, NameValueCollection)

Przetwarza dane ogłaszania zwrotnego dla TextBox kontrolki.Processes the postback data for the TextBox control.

LoadViewState(Object)

Przywraca informacje o stanie widoku z poprzedniego żądania, które zostało zapisane przy użyciu SaveViewState() metody.Restores view-state information from a previous request that was saved with the SaveViewState() method.

(Odziedziczone po WebControl)
MapPathSecure(String)

Pobiera ścieżkę fizyczną, do której jest mapowana ścieżka wirtualna (absolutna lub względna).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MergeStyle(Style)

Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki sieci Web, ale nie zastępuje żadnych istniejących elementów stylu formantu.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie dla formantu serwera jest przenoszone do hierarchii kontroli serwera interfejsu użytkownika strony.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Odziedziczone po Control)
OnDataBinding(EventArgs)

Podnosi DataBinding zdarzenie.Raises the DataBinding event.

(Odziedziczone po Control)
OnInit(EventArgs)

Podnosi Init zdarzenie.Raises the Init event.

(Odziedziczone po Control)
OnLoad(EventArgs)

Podnosi Load zdarzenie.Raises the Load event.

(Odziedziczone po Control)
OnPreRender(EventArgs)

Rejestruje skrypt klienta na potrzeby generowania zdarzeń ogłaszania zwrotnego przed renderowaniem na kliencie, jeśli AutoPostBack jest true .Registers client script for generating postback events prior to rendering on the client, if AutoPostBack is true.

OnTextChanged(EventArgs)

Podnosi TextChanged zdarzenie.Raises the TextChanged event. Pozwala to na bezpośrednie obsłużenie zdarzenia.This allows you to handle the event directly.

OnUnload(EventArgs)

Podnosi Unload zdarzenie.Raises the Unload event.

(Odziedziczone po Control)
OpenFile(String)

Pobiera informacje Stream używane do odczytu pliku.Gets a Stream used to read a file.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i informacje do elementu nadrzędnego formantu.Assigns any sources of the event and its information to the control's parent.

(Odziedziczone po Control)
RaisePostDataChangedEvent()

Wywołuje OnTextChanged(EventArgs) metodę, gdy dane ogłoszone dla TextBox formantu zostały zmienione.Invokes the OnTextChanged(EventArgs) method when the posted data for the TextBox control has changed.

RemovedControl(Control)

Wywoływana po usunięciu formantu podrzędnego z Controls kolekcji Control obiektu.Called after a child control is removed from the Controls collection of the Control object.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Renderuje TextBox formant do określonego HtmlTextWriter obiektu.Renders the TextBox control to the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Renderuje tag otwierającego HTML kontrolki do określonego składnika zapisywania.Renders the HTML opening tag of the control to the specified writer. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementu podrzędnego kontrolki serwera do podanego HtmlTextWriter obiektu, który zapisuje zawartość, która ma być renderowana na kliencie.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderContents(HtmlTextWriter)

Renderuje zawartość kontrolki do określonego składnika zapisywania.Renders the contents of the control to the specified writer. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu i przechowuje informacje o śledzeniu dla kontrolki, jeśli śledzenie jest włączone.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu za pomocą podanego ControlAdapter obiektu.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Odziedziczone po Control)
RenderEndTag(HtmlTextWriter)

Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania.Renders the HTML closing tag of the control into the specified writer. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
ResolveAdapter()

Pobiera adapter sterowania odpowiedzialny za renderowanie określonego formantu.Gets the control adapter responsible for rendering the specified control.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.Gets a URL that can be used by the browser.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na taki, który jest używany na żądającym klienta.Converts a URL into one that is usable on the requesting client.

(Odziedziczone po Control)
SaveControlState()

Zapisuje wszelkie zmiany stanu formantu serwera, które wystąpiły od momentu, gdy strona została opublikowana na serwerze.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Odziedziczone po Control)
SaveViewState()

Zapisuje zmiany w stanie widoku pola tekstowego od momentu, gdy strona została opublikowana z powrotem na serwerze.Saves the changes to the text box view state since the time the page was posted back to the server.

SaveViewState()

Zapisuje wszystkie Stany, które zostały zmodyfikowane po TrackViewState() wywołaniu metody.Saves any state that was modified after the TrackViewState() method was invoked.

(Odziedziczone po WebControl)
SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.Sets design-time data for a control.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń, aby renderować formant serwera i jego zawartość w jego formancie nadrzędnym.Assigns an event handler delegate to render the server control and its content into its parent control.

(Odziedziczone po Control)
SetTraceData(Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Odziedziczone po Control)
SetTraceData(Object, Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzenia, klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TrackViewState()

Powoduje, że formant śledzi zmiany stanu widoku, aby mogły być przechowywane we ViewState właściwości obiektu.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Odziedziczone po WebControl)

Zdarzenia

DataBinding

Występuje, gdy formant serwera wiąże się ze źródłem danych.Occurs when the server control binds to a data source.

(Odziedziczone po Control)
Disposed

Występuje, gdy formant serwera zostanie wystawiony z pamięci, który jest ostatnim etapem cyklu życia formantu serwera, gdy zażądano strony ASP.NET.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.

(Odziedziczone po Control)
Init

Występuje po zainicjowaniu formantu serwera, który jest pierwszym krokiem w jego cyklu życia.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Odziedziczone po Control)
Load

Występuje, gdy kontrolka serwera jest załadowana do Page obiektu.Occurs when the server control is loaded into the Page object.

(Odziedziczone po Control)
PreRender

Występuje po Control załadowaniu obiektu, ale przed renderowaniem.Occurs after the Control object is loaded but prior to rendering.

(Odziedziczone po Control)
TextChanged

Występuje, gdy zawartość pola tekstowego zostanie zmieniona między ogłoszeniami na serwerze.Occurs when the content of the text box changes between posts to the server.

Unload

Występuje, gdy formant serwera zostanie zwolniony z pamięci.Occurs when the server control is unloaded from memory.

(Odziedziczone po Control)

Jawne implementacje interfejsu

IAttributeAccessor.GetAttribute(String)

Pobiera atrybut kontrolki sieci Web o podanej nazwie.Gets an attribute of the Web control with the specified name.

(Odziedziczone po WebControl)
IAttributeAccessor.SetAttribute(String, String)

Ustawia atrybut formantu sieci Web na określoną nazwę i wartość.Sets an attribute of the Web control to the specified name and value.

(Odziedziczone po WebControl)
IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder .For a description of this member, see ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState() .For a description of this member, see GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary) .For a description of this member, see SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control) .For a description of this member, see SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData .For a description of this member, see UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings .For a description of this member, see DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings .For a description of this member, see HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions .For a description of this member, see Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions .For a description of this member, see HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object) .For a description of this member, see AddParsedSubObject(Object).

(Odziedziczone po Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Ładuje zawartość pola tekstowego ogłoszoną, jeśli różni się od ostatniego ogłaszania.Loads the posted text box content if it is different from the last posting.

IPostBackDataHandler.RaisePostDataChangedEvent()

Wywołuje OnTextChanged(EventArgs) metodę za każdym razem, gdy ogłoszone dane pola tekstowego zostały zmienione.Invokes the OnTextChanged(EventArgs) method whenever posted data for the text box has changed.

Metody rozszerzania

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonego formantu.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Zwraca obiekt obiektu z tabeli dla kontrolki zawierającej dane.Returns the metatable object for the containing data control.

Dotyczy

Zobacz też