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.

GridViewUpdateEventArgs.Keys الخاصية

Visual Studio 2010

يمكنك أيضا استخدام الخاصية مع butإلىn أمر إلى توفير معلومات إضافية حول الأمر إلى إجراء، مثل تعيين الترتيب التصاعدي.

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

public IOrderedDictionary Keys { get; }

قيمة الخاصية

النوع: System.Collections.Specialized.IOrderedDictionary
You can also provide an معالج الأحداث for the System.Collections.Specialized.IOrderedDictionary حدث إلى programmatically عنصر تحكم the إجراء performed when the زر أمر هو clicked.

When the DataKeyNames property of a GridView control is set, use the Keys property (dictionary) to access the value of the primary key in the row to update.


The following مثال demonstrates how إلى إنشاء a NewValues عنصر تحكم that displays نص في a OldValues عنصر تحكم when the ارتباط هو clicked. استخدم هذه construcإلىr إلى إنشاء وتهيئة مثيل جديد في NewValuesعنصر التحكم.OldValues

The following مثال illustrates how إلى إنشاء و يهيّئ a جديد مثيل of the Keys عنصر تحكم. DataKeyNames The following تعليمات برمجية مثال demonstrates how إلى يمنع the Keys أسلوب في a مخصص عنصر تحكم الخادم, so that the قائمة العنصر نص دوماً appears غامق.

You can specify (أو determine) whether التحقق من صحة هو performed تشغيل كلاهما the العميل و the الخادم when a DictionaryEntry.Key عنصر تحكم هو clicked بواسطة using the System.Collections.DictionaryEntry خاصية. Keys This حدث هو commonly used when لا الأمر اسم هو associated مع the DictionaryEntry.Value عنصر تحكم, كـ في the حالة of a إرسال زر.

The following مثال demonstrates how إلى specify و تعليمات برمجية a handler for the Keys حدث إلى عرض a رسالة when the عنصر تحكم هو clicked. الحصول على أو قم بتعيين وسيطة اختيارية التي تم تمريرها إلى حدث المعالج مع المقترنة الخاصية.

<%@ Page language="C#" %>
<%@ import namespace="System.IO" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "">

<script runat="server">

    void EmployeesGridView_RowUpdating(Object sender, GridViewUpdateEventArgs e)

        // Record the update operation in a log file.

        // Create the log text. 
        String logText = "";

        // Append the key field values to the log text.
        foreach (DictionaryEntry keyEntry in e.Keys)
            logText += keyEntry.Key + "=" + keyEntry.Value + ";";

        // Append the text to a log file.
        StreamWriter sw;
        sw = File.AppendText(Server.MapPath(null) + "\\updatelog.txt");


    void EmployeesGridView_RowUpdated(Object sender, GridViewUpdatedEventArgs e)

        if (e.Exception == null)
            // The update operation succeeded. Clear the message label.
            Message.Text = "";
            // The update operation failed. Display an error message.
            Message.Text = e.AffectedRows.ToString() + " rows updated. " + e.Exception.Message;
            e.ExceptionHandled = true;



<html xmlns="" >
<head id="Head1" runat="server">
    <title>GridViewUpdateEventArgs Keys Example</title>
        <form id="Form1" runat="server">

            <h3>GridViewUpdateEventArgs Keys Example</h3>

            <asp:label id="Message"


            <!-- The GridView control automatically sets the columns     -->
            <!-- specified in the datakeynames attribute as read-only.   -->
            <!-- No input controls are rendered for these columns in     -->
            <!-- edit mode.                                              -->
            <asp:gridview id="EmployeesGridView" 

            <!-- This example uses Microsoft SQL Server and connects -->
            <!-- to the Northwind sample database.                   -->
            <asp:sqldatasource id="EmployeesSqlDataSource"  
                selectcommand="SELECT [EmployeeID], [LastName], [FirstName], [HireDate] FROM [Employees]"
                updatecommand="UPDATE [Employees] SET [LastName] = @LastName, [FirstName] = @FirstName, [HireDate] = @HireDate WHERE [EmployeeID] = @EmployeeID" 
                ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                runat="server" >


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