This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

TextBox الفئة

Visual Studio 2010

تعيين السلوك الكائن في التحكم عند هو بالنقر فوق.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

[ControlValuePropertyAttribute("Text")]
[ValidationPropertyAttribute("Text")]
public class TextBox : WebControl, IPostBackDataHandler, 
	IEditableTextControl, ITextControl
<asp:TextBox />

في هذا الموضوع:

مقدمة

عنصر تحكم الخادم TextBox هو عنصر تحكم إدخال يسمح للمستخدم بإدخال نص وبشكل افتراضي , يتم تعيين الخاصية TextMode لعنصر التحكم إلى TextBoxMode.SingleLine، الذي يعرض مربع نص ذو خط مفرد TextBox يمثل قائمة تعداد التصرفات التي يمكن تطبيقها على TextModeالكائن داخل TextBoxMode.MultiLineعنصر تحكم.TextBoxMode.Password TextBox و Textالخصائص باستخدام قيم التعداد هذه لتعيين سلوك الكائن عند هو النقر فوقه.

في حالة تعيين كلتا الخاصيتين، TextBoxتحديد خاصية تشغيل كل فرد كائن له الأسبقية تشغيل الخاصية تشغيل عنصر تحكم. في ترتيب هو السيناريو، إذا كان Columnsعنصر التحكم خاصية هو أما أو بدون القيمة هو المحددة، فإن سلوك الافتراضي هو للتنقل إلى URL. إذا TextBoxسلوك عنصر التحكم هو غير محدد باستخدام أي Rowsخاصية أو خاصية تشغيل كائنات تحتوي عليها بشكل افتراضي هو سلوك . بالإضافة إلى ذلك، إذا TextBoxخصائص تشغيل Wrapتشغيل الكائنات التي trueيحتوي تشغيل عنصر تحكم تم تعيينها إلى وعدم وجود القيمة هو المحددة خاصية، هو سلوك الافتراضي .

إذا قمت بتحديد TextBoxلأي خاصية أو خاصية، الصفحة التنقل إلى محدد موقع معلومات عند هو بالنقر فوق. استخدم ReadOnlyأو trueلتعيين URL للانتقال إلى خاصية. إذا قمت بتحديد MaxLengthلأي خاصية أو إعادة النشر إلى الخادم يقوم بإنشاء خاصية، الصفحة عند هو بالنقر فوق.

للحصول على قائمة قيم الخصائص الأولية لمثيل TextBox، انظر TextBoxالمنشئ.

ملاحظة تنبيهتنبيه

سيتم تمرير هذا الاسم في بيانات حدث عند حدوث أحداث إعادة النشر. استخدم هذه construcإلىr إلى يهيّئ مثيل جديد فئة استخدام فهرس الصف المحدد. لمزيد من المعلومات، راجع تأمين عناصر التحكم القياسية ، كيفية: حماية من عمليات استغلال البرنامج النصي في تطبيق ويب من خلال تطبيق ترميز HTML إلى سلاسل ، و التحقق من صحة إدخالات المستخدم في صفحات ASP.NET على ويب.

بناء جملة مصرحة

<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"
/>

TopicLocation
كيفية القيام بما يلي: الحصول على قيم وتعيينها في عناصر تحكم خادم الويب "مربع النص"dv_vwdcon
كيفية القيام بما يلي: الاستجابة إلى التغييرات في مربع نص عنصر تحكم خادم ويبdv_vwdcon
كيفية القيام بما يلي: قم بتعيين خصائص عنصر تحكم خادم ويب ASP.NETdv_vwdcon
الإرشادات التفصيلية: إنشاء واستخدام الصفحات ASP.NET الرئيسية في ‏‫Visual Web Developerdv_vwdcon
كيفية القيام بما يلي: Set a TextBox عنصر تحكم خادم ويب for Password Entrydv_vwdcon
كيفية القيام بما يلي: الحماية من عمليات استغلال البرنامج النصي في تطبيق الويب من خلال تطبيق ترميز HTML إلى سلاسلdv_vwdcon
الإرشادات التفصيلية: التحقق من صحة إدخالات مستخدم في الصفحة نماذج ويبdv_vwdcon
كيفية القيام بما يلي: تعيين تركيز تشغيل ملقم ويب ASP.NET عناصر التحكمdv_vwdcon
الإرشادات التفصيلية: ربط بيانات إلى كائن أعمال مخصصdv_vwdcon
الإرشادات التفصيلية: إنشاء صفحة ويب أساسية في ‏‫Visual Web Developerdv_vwdcon
كيفية القيام بما يلي: تحديد إدخال متعدد الأسطر من أجل عنصر تحكم خادم ويب TextBox (مربع نص)dv_vwdcon

لإنشاء مساحة غير نشط داخل فعالة نشطة، قم بتحديد الفعالة غير نشطة قبل نشطاً في TextBoxعنصر تحكم. يوضح المثال تعليمات برمجية التالي كيفية استخدام قيم التعداد ل التعيين خاصية.

ملاحظة الأمانملاحظة الأمان

يحتوي هذا المثال على مربع نص يقبل إدخال المستخدم و الذي يعد تهديد أمان محتمل. بشكل افتراضي، تتحقق صفحات ويب ASP.NET من أن مُدخلات المستخدم لا تتضمن برنامج نصي أو عناصر HTML. لمزيد من المعلومات، راجع نظرة عامة حول عمليات استغلال البرنامج النصي.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" > 

<head>
    <title> 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>

      <table>

         <tr>

            <td colspan="5">

               Enter integer values into the text boxes. <br />
               Click the Add button to add the two values. <br />
               Click the Reset button to reset the text boxes.

            </td>

         </tr>

         <tr>

            <td colspan="5">

               &nbsp;

            </td>

         </tr>

         <tr align="center">

            <td>

               <asp:TextBox ID="Value1"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               + 

            </td>

            <td>

               <asp:TextBox ID="Value2"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               =

            </td>

            <td>

               <asp:Label ID="AnswerMessage"
                    runat="server"/>

            </td>

         </tr>

         <tr>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value1RequiredValidator"
                    ControlToValidate="Value1"
                    ErrorMessage="Please enter a value.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value1RangeValidator"
                    ControlToValidate="Value1"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value2RequiredValidator"
                    ControlToValidate="Value2"
                    ErrorMessage="Please enter a value.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value2RangeValidator"
                    ControlToValidate="Value2"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td>

               &nbsp

            </td>

         </tr>

         <tr align="center">

            <td colspan="4">

               <asp:Button ID="AddButton"
                    Text="Add"
                    OnClick="AddButton_Click"
                    runat="server"/>

            </td>

            <td>

               &nbsp;

            </td>

         </tr>

      </table>

   </form>

</body>
</html>


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: