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.

Button.ValidationGroup الخاصية

Visual Studio 2010

الحصول أو تعيين مجموعة عنصر تحكم s الذي Buttonعنصر تحكم يؤدي إلى التحقق من صحة عند ذلك بنشر مرة أخرى إلى الخادم.

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

[ThemeableAttribute(false)]
public virtual string ValidationGroup { get; set; }
<asp:Button ValidationGroup="String" />

قيمة الخاصية

النوع: System.String
مجموعة عنصر تحكم s الذي Buttonعنصر تحكم يؤدي إلى التحقق من صحة عند ذلك بنشر مرة أخرى إلى الخادم. القيمة افتراضية سلسلة فارغ ("").

التطبيقات

IButtonControl.ValidationGroup

التحقق من صحة المجموعات تسمح لك بتعيين عناصر التحكم للتحقق من الصحة تشغيل صفحة إلى فئة معينة. يمكن التحقق من صحة كل مجموعة التحقق من صحة صورة مستقلة عن المجموعات الأخرى التحقق من الصحة "تشغيل الصفحة. استخدام ValidationGroupخاصية لتحديد اسم مجموعة التحقق من صحة التي Buttonعنصر تحكم يؤدي إلى التحقق من صحة عند ذلك بنشر مرة أخرى إلى الخادم.

هذه خاصية تأثير فقط عند CausesValidationتعيين خاصية إلى القيمة true. عند تحديد القيمة ل ValidationGroupخاصية، فقط التحقق من الصحة التي جزء من المجموعة المحددة تكون عناصر تحكم التحقق من صحة عند Buttonبنشر عنصر التحكم مرة أخرى إلى الخادم. If you do not specify a القيمة for this خاصية و the CausesValidation خاصية هو التعيين to true, الجميع التحقق من صحة عناصر التحكم تشغيل the الصفحة that are not تعيين إلى a التحقق من صحة مجموعة are validated when the عنصر تحكم posts الخلف to the الخادم.

This خاصية cannot be التعيين بواسطة themes أو النمط ورقة themes. للمزيد من المعلومات، راجع ThemeableAttribute وسمات ASP.NET و الأسطح.

يوضح مثال التعليمة البرمجية التالي كيفية استخدام ValidationGroup خاصية لتحديد s عنصر تحكم عند التحقق من صحة Button عنصر تحكم عمليات النشر مرة أخرى إلى الخادم. تحتوي الصفحة على ثلاثة مربعات النص إلى يلتقط البيانات من ثلاثة والمستخدمRequiredFieldValidator عناصر تحكم إلى تأكد من أن مستخدم عدم ترك مربع نص فارغاً. The RequiredFieldValidator عناصر تحكم مربعات النص الأولين حساسة في PersonalInfoGroup التحقق من صحة مجموعة و RequiredFieldValidator هو مربع نص الثالث في التحكم LocationInfoGroup التحقق من صحة مجموعة. عند Button1 النقر فوق عناصر التحكم في مجموعة التحقق من الصحة فقط PersonalInfoGroup يتم التحقق من صحة. عند Button2 النقر فوق عناصر التحكم في مجموعة التحقق من الصحة فقط LocationInfoGroupيتم التحقق من صحة.

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

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


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

<!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 id="head1" runat="server">
  <title>Button.ValidationGroup Example</title>
</head>
<body>
  <form id="form1" runat="server">

    <h3>Button.ValidationGroup Example</h3>

    <asp:label id="NameLabel" 
      text="Enter your name:"
      runat="Server"
      AssociatedControlID="NameTextBox">
    </asp:label>

    &nbsp;

    <asp:textbox id="NameTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator1"
      controltovalidate="NameTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your name."
      runat="Server">
    </asp:requiredfieldvalidator>

    <br /><br />

    <asp:label id="AgeLabel" 
      text="Enter your age:"
      runat="Server" 
      AssociatedControlID="AgeTextBox">
    </asp:label>

    &nbsp;

    <asp:textbox id="AgeTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator2"
      controltovalidate="AgeTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your age."
      runat="Server">
    </asp:requiredfieldvalidator>

    <br /><br />

    <!--When Button1 is clicked, only validation
    controls that are a part of PersonalInfoGroup
    are validated.-->
    <asp:button id="Button1" 
      text="Validate" 
      causesvalidation="true"
      validationgroup="PersonalInfoGroup"
      runat="Server" />

    <br /><br />

    <asp:label id="CityLabel" 
      text="Enter your city of residence:"
      runat="Server" 
      AssociatedControlID="CityTextBox">
    </asp:label>

    &nbsp;

    <asp:textbox id="CityTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator3"
      controltovalidate="CityTextBox"
      validationgroup="LocationInfoGroup"
      errormessage="Enter a city name."
      runat="Server">
    </asp:requiredfieldvalidator>

    <br /><br />

    <!--When Button2 is clicked, only validation
    controls that are a part of LocationInfoGroup
    are validated.-->
    <asp:button id="Button2" 
      text="Validate" 
      causesvalidation="true"
      validationgroup="LocationInfoGroup"
      runat="Server" />

  </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
إظهار: