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.

HtmlForm.DefaultButton الخاصية

Visual Studio 2010

الحصول أو تعيين عنصر التحكم التابعة من HtmlFormعنصر التحكم الذي يؤدي إلى إعادة النشر عند مفتاح Enter الزر هو الضغط.

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

public string DefaultButton { get; set; }
<asp:HtmlForm DefaultButton="String" />

قيمة الخاصية

النوع: System.String
ID لعنصر تحكم زر إلى dهوplay كالافتراضي الزر عند HtmlFormهو تحميل. القيمة افتراضية هو سلسلة فارغ ("").

استثناء:شرط
InvalidOperationException

التحكم بالإشارة إليها كإعداد افتراضي زر ليست من نوع IButtonControl.

DefaultButton خاصية يتيح لك تحديد أن المستخدمين يمكن أن تسبب إعادة النشر بواسطة الضغط على Enter الزر في عنصر تحكم إدخال في النموذج (مثل كـ صندوق نص). يمكنك تعيين كافتراضي زر أي عنصر تحكم مشتقة من IButtonControlالواجهة باستثناء LinkButtonعنصر التحكم. إذا كان عنصر التحكم الذي يتم الرجوع إليها بواسطة DefaultButtonخاصية لا ينحدر من IButtonControl، InvalidOperationExceptionطرح استثناء.

إذا كنت تستخدم الصفحات الرئيسية وقمت بتعيين DefaultButtonالخاصية من صفحة محتوى، استخدم UniqueIDخاصية IButtonControlالزر. لمزيد من المعلومات حول الصفحات الرئيسية ، راجع الصفحات الرئيسية.

DefaultButton قد خاصية لا يؤدي إعادة النشر في السيناريوهات التالية:

  • يؤدي ضغط Enter الزر عند تركيز هو خارج إدخال عناصر التحكم في النموذج. إجراء الافتراضي إعادة النشر هو لا يمكن ضمان تشغيل.

  • يؤدي ضغط Enter الزر عند تركيز هو داخل صندوق نص تعدد الخطوط. في صندوق نص تعدد الخطوط، سلوك المتوقع هو الذي يقوم بضغط Enter الزر إنشاء سطر جديد في صندوق النص. في بعض المستعرضات، والضغط على Enter الزر داخل تعدد-خط صندوق نص تشغيل إعادة النشر. في هذه الحالة، إذا أردت ENTER لإنشاء سطر جديد بدلاً من ذلك، يمكنك يرفق دالة JavaScript الإدخال عنصر تحكم. يجب يلتقط برنامج نصي على المفتاح Enter الزر و إيقاف إعادة النشر. على سبيل المثال، يمكنك استخدام Attributesمجموعة خاصية إلى إضافة برنامج العميل النصي والخاص onKeyPressحدث.

  • تعيين LinkButtonعنصر تحكم كزر افتراضي. فقط Buttonو ImageButtonيتم اعتماد عناصر التحكم.

  • تغيير DefaultButtonالخصائص برمجياً من خلال غير متزامن إعادة النشر. يمكن ممكّن postbacks غير متزامنة تشغيل صفحة بواسطة إضافة واحد أو المزيد UpdatePanelعناصر إلى الصفحة. للمزيد من المعلومات، راجع نظرة عامة حول التحكم UpdatePanel ونطرة عامة حول عرض صفحة جزئية.

يظهر المثال التالي كيفية تعيين DefaultButtonخاصية تعيين الموضع الافتراضي عنصر تحكم تؤدي إعادة النشر.


<%@ page language="C#" %>

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

  void Page_Load(object sender, System.EventArgs e)
  {

    // Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to "
                + Form1.DefaultButton.ToString() + "<br/>";
    Label2.Text = "The DefaultFocus property is set to "
                + Form1.DefaultFocus.ToString();
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">

    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        

    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>

    <br />

    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>

    <br /><br />

    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>

    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>

    <hr />

    <asp:label id="Label1"
               runat="Server">
    </asp:label>

    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </form>

</body>

</html>


نظام التشغيل 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
إظهار: