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.

SqlDataSourceView.ExecuteUpdate أسلوب

Visual Studio 2010

Performs an update operation using the UpdateCommand SQL string, any parameters that are in the UpdateParameters collection, and the values that are in the specified keys, values, and oldValues collections.

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

protected override int ExecuteUpdate(
	IDictionary keys,
	IDictionary values,
	IDictionary oldValues
)

المعلمات

keys
النوع: System.Collections.IDictionary
An IDictionary of primary keys to use with the UpdateCommand property to perform the update database operation. Gets the معلمات مجموعة containing the معلمات that are used بواسطة the UpdateCommand خاصية. null
values
النوع: System.Collections.IDictionary
أسماء المعلمات قد تتأثر ب IDictionaryالخاصية؛ على وجه الخصوص، إذا كان الاسم تقوم بتعريف المفتاح أساسي، مثل المفتاح التي يتم تحديد استخدام UpdateCommandخاصية ربط البيانات عنصر تحكم، أو حذفها وتحديث وحدات السيناريو التي تعيين الخاصية إلى قيمة مجموعة من يتم تمرير إلى المقابلة البيانات الأسلوب. You must بوضوح declare the UpdateCommand خاصية و يتصل the null أسلوب when using بيانات-حدود عناصر التحكم, such كـ the (unlike عناصر التحكم, such كـ the و , which automatically يملأ the معلمات و يتصل the أسلوب تشغيل a بيانات التحكم بالمصادر).
oldValues
النوع: System.Collections.IDictionary
Therefore, you cannot إلغاء الأمر the IDictionary operation directly بواسطة calling the أسلوب تشغيل the كائن that هو exposed بواسطة the كائن. UpdateCommand الكائن الذي هو تم تمريره بواسطة nullمعلمة هو المستخدمة من قبل عرض مصدر بيانات للوصول إلى معلمة الكائنات، مثل و الخصائص.

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

النوع: System.Int32
If the خاصية هو التعيين إلى و caching هو ممكّن, the كائن retrieves بيانات من و saves بيانات إلى the ذاكرة تخزين مؤقت during the تشغيل.

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

الحصول أو تعيين تبعية المفتاح المعرفة من قبل مستخدم هو مرتبطة بكافة كائنات ذاكرة التخزين المؤقت للبيانات التي يتم إنشاؤها بواسطة التحكم بمصدر البيانات.SqlDataSource

-أو-

عناصر تحكم حدود بيانات، مثل ConflictDetectionو CompareAllValues، يمكن تكوينه لإجراء التحديثات تلقائياً باستخدام oldValues، بينما غير ذلك عناصر لا.

HttpException

الحصول القيمة تشير إلى ما إذا كان الكائن الذي هو المقترنة الحالية يدعم التحكم في عملية الحذف.

NotSupportedException

TheCanUpdateproperty هوfalse.

You can, however, إلغاء الأمر the تشغيل بواسطة إعداد the SqlDataSourceView خاصية of the ExecuteUpdate إلى . الصفحة المطورين و الكتاب عنصر تحكم حدود بيانات لا استدعاء في ExecuteUpdateمباشرة؛ وبدلاً من ذلك، يستخدم الأسلوب علنا المكشوفة Updateالأسلوب.

The values contained in the keys and values collections are evaluated and merged with any values contained by the UpdateParameters collection. If the ConflictDetection property is set to CompareAllValues, the values contained in the oldValues collection are formatted with the OldValuesParameterFormatString and also merged.

Before the update operation is performed, the OnUpdating method is called to raise the Updating event. المثيل عنصر تحكم هو عنصر تحكم وتم رفض الوصول إلى مسار المحدد خاصية.

To perform the operation, the SqlDataSourceView builds a DbCommand object using the UpdateCommand text and any associated UpdateParameters properties, and then executes the DbCommand object against the underlying database. يمكنك تعيين OnUpdatedخاصية لإنشاء تبعية بين الجميع إدخالات ذاكرة تخزين مؤقت التي يتم إنشاؤها بواسطة Updatedعنصر تحكم المفتاح. يمكنك برمجياً صلاحية الجميع إدخالات ذاكرة تخزين مؤقت في أي وقت بواسطة انتهاء صلاحية المفتاح.

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