GridViewDeleteEventArgs.Keys 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得表示要刪除之主索引鍵的欄位名稱/值組的字典。
public:
property System::Collections::Specialized::IOrderedDictionary ^ Keys { System::Collections::Specialized::IOrderedDictionary ^ get(); };public System.Collections.Specialized.IOrderedDictionary Keys { get; }member this.Keys : System.Collections.Specialized.IOrderedDictionaryPublic ReadOnly Property Keys As IOrderedDictionary屬性值
字典，包含表示要刪除之資料列主索引鍵的欄位名稱/值組。
範例
下列範例示範如何使用 Values 屬性來取得要刪除之資料列索引鍵欄位的值。 然後，這些值會寫入已刪除記錄的記錄檔。
<%@ Page language="C#" %>
<%@ import namespace="System.IO" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomersGridView_RowDeleting(Object sender, GridViewDeleteEventArgs e)
{
// Record the delete operation in a log file.
// Create the log text.
String logText = "";
// Append the values of the key fields to the log text.
foreach (DictionaryEntry keyEntry in e.Keys)
{
logText += keyEntry.Key + "=" + keyEntry.Value + ";";
}
// Append the values of the non-key fields to the log text.
foreach (DictionaryEntry valueEntry in e.Values)
{
logText += valueEntry.Key + "=" + valueEntry.Value + ";";
}
// Display the log content.
LogTextLabel.Text = logText;
// Append the text to a log file.
try
{
StreamWriter sw;
sw = File.AppendText(Server.MapPath(null) + "\\deletelog.txt");
sw.WriteLine(logText);
sw.Flush();
sw.Close();
}
catch(UnauthorizedAccessException ex)
{
// You must provide read/write access to the file using ACLs.
LogErrorLabel.Text = "You do not have permission to write to the log.";
}
}
void CustomersGridView_RowDeleted(Object sender, GridViewDeletedEventArgs e)
{
if (e.Exception == null)
{
// The delete operation succeeded. Clear the message label.
Message.Text = "";
}
else
{
// The delete operation failed. Display an error message.
Message.Text = e.AffectedRows.ToString() + " rows deleted. " + e.Exception.Message;
e.ExceptionHandled = true;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewDeleteEventArgs Keys and Values Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewDeleteEventArgs Keys and Values Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:label id="LogTextLabel"
forecolor="Red"
runat="server"/>
<br/>
<asp:label id="LogErrorLabel"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="CustomersGridView"
allowpaging="true"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
autogeneratedeletebutton="true"
datakeynames="CustomerID"
onrowdeleted="CustomersGridView_RowDeleted"
onrowdeleting="CustomersGridView_RowDeleting"
runat="server">
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
deletecommand="Delete from Customers where CustomerID = @CustomerID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<%@ import namespace="System.IO" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub CustomersGridView_RowDeleting(ByVal sender As Object, ByVal e As GridViewDeleteEventArgs)
' Record the delete operation in a log file.
' Create the log text.
Dim logText As String = ""
' Append the values of the key fields to the log text.
Dim i As Integer
For i = 0 To e.Keys.Count - 1
logText &= e.Keys(i).ToString() & ";"
Next
' Append the values of the non-key fields to the log text.
For i = 0 To e.Values.Count - 1
If e.Values(i) IsNot Nothing Then
logText &= e.Values(i).ToString() & ";"
Else
logText &= "Nothing" & ";"
End If
Next
' Display the log content.
LogTextLabel.Text = logText
' Append the text to a log file.
Try
Dim sw As StreamWriter
sw = File.AppendText(Server.MapPath(Nothing) & "\deletelog.txt")
sw.WriteLine(logText)
sw.Flush()
sw.Close()
Catch ex As UnauthorizedAccessException
' You must provide read/write access to the file using ACLs.
LogErrorLabel.Text = "You do not have permission to write to the log."
End Try
End Sub
Sub CustomersGridView_RowDeleted(ByVal sender As Object, ByVal e As GridViewDeletedEventArgs)
If e.Exception Is Nothing Then
' The delete operation succeeded. Clear the message label.
Message.Text = ""
Else
' The delete operation failed. Display an error message.
Message.Text = e.AffectedRows.ToString() & " rows deleted. " & e.Exception.Message
e.ExceptionHandled = True
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewDeleteEventArgs Keys and Values Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewDeleteEventArgs Keys and Values Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:label id="LogTextLabel"
forecolor="Red"
runat="server"/>
<br/>
<asp:label id="LogErrorLabel"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="CustomersGridView"
allowpaging="true"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
autogeneratedeletebutton="true"
datakeynames="CustomerID"
onrowdeleted="CustomersGridView_RowDeleted"
onrowdeleting="CustomersGridView_RowDeleting"
runat="server">
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
deletecommand="Delete from Customers where CustomerID = @CustomerID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
備註
DataKeyNames設定控制項的 GridView 屬性時，請使用 Keys 屬性 (字典) ，以取得要刪除之資料列的主鍵或索引鍵值。
注意
若要取得非索引鍵欄位的值，請使用 Values 屬性。
Keys字典會自動填入 屬性中指定的 DataKeyNames 欄位名稱/值組。 如果多個欄位形成主鍵，則會將個別專案新增至每個索引鍵欄位的 Keys 字典中。
若要判斷索引鍵欄位的名稱，請使用 DictionaryEntry.Key 字典中的 Keys 物件屬性 System.Collections.DictionaryEntry 。 若要判斷索引鍵欄位的值，請使用 DictionaryEntry.Value 屬性。
