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.

SqlDataSource.Select أسلوب

Visual Studio 2010

وأخيراً، بعد بيانات هو المدرج في قاعدة بيانات بواسطة SelectCommandعنصر التحكم، SelectParametersمعالج الأحداث هو استدعاء لمعالجة حدث، قيمة المفتاح أساسي للصف المدرج هو dهوplayed و أسلوب عنصر التحكم هو تسمى بوضوح بتحديث البيانات.

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

public IEnumerable Select(
	DataSourceSelectArguments arguments
)

المعلمات

arguments
النوع: System.Web.UI.DataSourceSelectArguments
يحدث عندما يكون لعملية إدراج مكتمل.DataSourceSelectArguments

القيمة المُرجعة

النوع: System.Collections.IEnumerable
معالجة IEnumerableالحدث إلى فحص قيم معلمات الإخراج بعد اكتمال عملية إدراج.

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

يوضح المثال تعليمات برمجية التالي كيفية استرداد بيانات من "الخادم SQL Microsoft Office 2010 Suite" وعرضه في SqlDataSourceعنصر تحكم وكيفية استخدام عنصر تحكم لمعرفة التفاصيل الخاصة بالصف المحدد في كنموذج لإدخال سجلات جديدة.

وأخيراً، بعد بيانات هو المدرج في قاعدة بيانات بواسطة Selectعنصر التحكم، PreRenderمعالج الأحداث هو استدعاء لمعالجة حدث، قيمة المفتاح أساسي للصف المدرج هو dهوplayed، و أسلوب عنصر التحكم هو تسمى بوضوح بتحديث البيانات. It is called by data-bound controls that have been attached to a SqlDataSource control through their DataSourceID property.

The Select method returns a DataView object if the DataSourceMode property is set to the DataSet value. The Select method returns a IDataReader object if the DataSourceMode property is set to the DataReader value. لذلك، لا يمكنك إلغاء الأمر العملية مباشرة بواسطة استدعاء IDataReaderالأسلوب تشغيل الكائنات التي هو كشف بواسطة خاصية.

Select يمكن الاستدلال الصحيح معلمات أي OnSelectingالكائن ومعلمة Selectingعند استخدام ASP.NET بناء ربط بيانات ثنائية الاتجاه. Select و موفري إقران المعلمات الموجودة في مجموعة طبقاً إلى الترتيب الذي تظهر المعلمات في معلمات SQL الاستعلام.

Select الموفر هو موفر ADO.NET الافتراضي OnSelectedعنصر تحكم، يقوم بربط المعلمات الموجودة في المجموعة يطابق اسم معلمة مع اسم مستعار للبريد العنصر نائب في استعلام SQL.Selected يمكنك برمجياً صلاحية الجميع إدخالات ذاكرة تخزين مؤقت في أي وقت بواسطة انتهاء صلاحية المفتاح.

If the DataSourceMode property is set to SqlDataSourceMode.DataSet and caching is enabled, the SqlDataSource object retrieves data from and saves data to the cache during the Select operation. الحصول أو تعيين سلسلة تنسيق لتطبيق أسماء أي معلمات التي تم تمريرها إلى CacheDurationأو CacheExpirationPolicyالأسلوب.

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

These أمثلة إظهار how إلى استخدم declarative بناء الجملة for بيانات الوصول. For معلومات حول how إلى الوصول بيانات بواسطة using تعليمات برمجية instead of ترميز, see . The following تعليمات برمجية مثال demonstrates how إلى استخدم a عنصر تحكم declaratively إلى retrieve بيانات من SQL الخادم و عرض it في a عنصر تحكم. سلسلة تمثل سلسلة تنسيق المطبق على أسماء أي المعلمات التي تم تمريرها إلى أو الأساليب.

If the DataSourceMode property is set to SqlDataSourceMode.DataSet and a FilterExpression property has been specified, the filter expression is evaluated with any supplied FilterParameters properties and the resulting filter is applied to the list of data during the Select operation.

The Select method delegates to the Select method of the SqlDataSourceView object that is associated with the SqlDataSource control. SqlDataSourceView تنسيق سلسلة هو تطبيقها فقط على مفاتيح أساسية، مثل تلك التي تعرف DbCommandخاصية لعنصر تحكم حدود بيانات المقترن، أو في يحذف وتحديث وحدات سيناريو الموقع SelectCommandخاصية هو معينة إلى القيمة التعيين من SelectParametersDbCommandالتي تم تمريرها إلى المقابلة بيانات الأسلوب.

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

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

في ترتيب هو الحالة، سلسلة التنسيق هو المطبق على كل اسم المعامل في Selectمجموعة. السيناريوهات عام الثاني بحيث يمكنك تغيير خاصية كـ التالي:


<asp:SqlDataSource 
    ID="SqlDataSource1" 
    runat="server" 
    ConnectionString="<%$ ConnectionStrings:ConnectionString %>" 
    SelectCommand="SELECT Count(*) FROM [Products] WHERE ([ReorderLevel] &gt; 0)">
</asp:SqlDataSource>
<asp:Label 
    ID="Label1" 
    runat="server" 
    Text="">
</asp:Label>
<br />
<asp:Button 
    ID="Button1" 
    Text="Check Reorder Status" 
    runat="server" 
    onclick="Button1_Click" />


إلى التمييز بين قيم القديمة والجديدة في التحديثات.Select عند SqlDataSourceخاصية هو تعيين إلى قيمة، معلمات للقيمتين الأصلية والجديدة المضافة إلى التعيين. The value of the integer is used to set the text of a Label control and to determine whether to display a HyperLink control.


protected void CheckReorderStatus()
{
    DataView dv = (DataView)SqlDataSource1.Select(DataSourceSelectArguments.Empty);
    int reorderedProducts = (int)dv.Table.Rows[0][0];
    if (reorderedProducts > 0)
    {
        Label1.Text = "Number of products on reorder: " + reorderedProducts;
    }
    else
    {
        Label1.Text = "No products on reorder.";
    }
}

protected void Button1_Click(object sender, EventArgs e)
{
    CheckReorderStatus();
}


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