System.Web.UI.WebControls.FormViewDeleteEventArgs.Keys Property

Gets an ordered dictionary of key field name/value pairs for the record to delete.

Syntax

public System.Collections.Specialized.IOrderedDictionary Keys { get; }

Value

Documentation for this section has not yet been entered.

Remarks

The FormViewDeleteEventArgs.Keys property contains the values of the key fields listed in the FormView.DataKeyNames property of a System.Web.UI.WebControls.FormView control. Use the FormViewDeleteEventArgs.Keys property to access the values of the key field or fields for the record to be deleted. For example, you can use these values to verify the record before deleting it, to change the record to delete, or to keep a log of deleted records.

Note:

This property contains only the key fields. To access the name/value pair values for the non-key fields, use the FormViewDeleteEventArgs.Values property.

The FormViewDeleteEventArgs.Keys property returns an System.Collections.Specialized.OrderedDictionary object that implements the System.Collections.Specialized.IOrderedDictionary interface. The System.Collections.Specialized.OrderedDictionary object contains DictionaryEntry objects that represent the key fields. To access the key field names, use the System.Collections.Specialized.OrderedDictionary.Keys property of the System.Collections.Specialized.OrderedDictionary object. Similarly, you can access the key field values by using the System.Collections.Specialized.OrderedDictionary.Values property.

Note:

As a shortcut, you can also use the indexer of the System.Collections.Specialized.OrderedDictionary object to access the key field values. The advantage in using the indexer is that it returns key field values directly. Data source controls that rely on the field order (such as System.Web.UI.WebControls.AccessDataSource) can access key field values only by index.

The FormViewDeleteEventArgs.Keys and FormViewDeleteEventArgs.Values properties are read-only; however, you can modify the field values of the System.Collections.Specialized.OrderedDictionary object. If you change the key and non-key field values, the corresponding record will be deleted from the data source.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0