DetailsViewInsertedEventArgs Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje data pro událost ItemInserted.
public ref class DetailsViewInsertedEventArgs : EventArgspublic class DetailsViewInsertedEventArgs : EventArgstype DetailsViewInsertedEventArgs = class
inherit EventArgsPublic Class DetailsViewInsertedEventArgs
Inherits EventArgs- Dědičnost
Příklady
Následující příklad kódu ukazuje, jak použít DetailsViewInsertedEventArgs objekt předaný obslužné rutině ItemInserted události události k určení, zda došlo k výjimce během operace vložení.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomerDetailsView_ItemInserted(Object sender,
DetailsViewInsertedEventArgs e)
{
// Use the Exception property to determine whether an exception
// occurred during the insert operation.
if (e.Exception == null && e.AffectedRows == 1)
{
// Use the Values property to get the value entered by
// the user for the CompanyName field.
String name = e.Values["CompanyName"].ToString();
// Display a confirmation message.
MessageLabel.Text = name + " added successfully. ";
}
else
{
// Insert the code to handle the exception.
MessageLabel.Text = e.Exception.Message;
// Use the ExceptionHandled property to indicate that the
// exception is already handled.
e.ExceptionHandled = true;
// When an exception occurs, keep the DetailsView
// control in insert mode.
e.KeepInInsertMode = true;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsViewInsertedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsViewInsertedEventArgs Example</h3>
<asp:detailsview id="CustomerDetailsView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateinsertbutton="true"
autogeneraterows="true"
allowpaging="true"
oniteminserted="CustomerDetailsView_ItemInserted"
runat="server">
<fieldheaderstyle backcolor="Navy"
forecolor="White"/>
</asp:detailsview>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- 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="DetailsViewSource"
selectcommand="Select [CustomerID], [CompanyName], [Address],
[City], [PostalCode], [Country] From [Customers]"
insertcommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode],
[Country]) VALUES (@CustomerID, @CompanyName, @Address,
@City, @PostalCode, @Country)"
connectionstring=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
<%@ Page language="VB" autoeventwireup="false" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub CustomerDetailsView_ItemInserted(ByVal sender As Object, _
ByVal e As DetailsViewInsertedEventArgs) _
Handles CustomerDetailsView.ItemInserted
' Use the Exception property to determine whether an exception
' occurred during the insert operation.
If e.Exception Is Nothing And e.AffectedRows = 1 Then
' Use the Values property to get the value entered by
' the user for the CompanyName field.
Dim name As String = e.Values("CompanyName").ToString()
' Display a confirmation message.
MessageLabel.Text = name & " added successfully. "
Else
' Insert the code to handle the exception.
MessageLabel.Text = e.Exception.Message
' Use the ExceptionHandled property to indicate that the
' exception is already handled.
e.ExceptionHandled = True
' When an exception occurs, keep the DetailsView
' control in insert mode.
e.KeepInInsertMode = True
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsViewInsertedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsViewInsertedEventArgs Example</h3>
<asp:detailsview id="CustomerDetailsView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateinsertbutton="true"
autogeneraterows="true"
allowpaging="true"
runat="server">
<fieldheaderstyle backcolor="Navy"
forecolor="White"/>
</asp:detailsview>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- 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="DetailsViewSource"
selectcommand="Select [CustomerID], [CompanyName], [Address],
[City], [PostalCode], [Country] From [Customers]"
insertcommand="INSERT INTO [Customers]([CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
connectionstring=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Poznámky
Ovládací DetailsView prvek vyvolá ItemInserted událost, když se v ovládacím prvku klikne tlačítko Vložit (tlačítko s CommandName jeho vlastností nastavenou na "Vložit") v ovládacím prvku, ale po DetailsView vložení záznamu. To umožňuje poskytnout obslužnou rutinu události, která provádí vlastní rutinu, například kontrolu výsledků operace vložení, kdykoli dojde k této události.
DetailsViewInsertedEventArgs Objekt se předá obslužné rutině události, která umožňuje určit počet ovlivněných záznamů a všechny výjimky, ke kterým mohlo dojít. Chcete-li určit počet záznamů ovlivněných operací vložení, použijte AffectedRows vlastnost. Exception Pomocí vlastnosti určete, zda došlo k výjimkám. Můžete také určit, zda byla výjimka zpracována v obslužné rutině události nastavením ExceptionHandled vlastnosti. Pokud potřebujete získat přístup k hodnotám vloženého záznamu, použijte Values tuto vlastnost.
Ve výchozím nastavení DetailsView se ovládací prvek vrátí do režimu určeného DefaultMode vlastností po operaci vložení. Chcete-li zachovat DetailsView ovládací prvek v režimu vložení, nastavte KeepInInsertMode vlastnost na true.
Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.
Seznam počátečních hodnot vlastností pro instanci DetailsViewDeletedEventArgs třídy naleznete v konstruktoru DetailsViewDeletedEventArgs .
Konstruktory
| Name | Description |
|---|---|
| DetailsViewInsertedEventArgs(Int32, Exception) |
Inicializuje novou instanci DetailsViewInsertedEventArgs třídy. |
Vlastnosti
| Name | Description |
|---|---|
| AffectedRows |
Získá počet řádků ovlivněných operací vložení. |
| Exception |
Získá výjimku (pokud existuje), která byla vyvolána během operace vložení. |
| ExceptionHandled |
Získá nebo nastaví hodnotu určující, zda byla vyvolána výjimka během operace vložení byla zpracována v obslužné rutině události. |
| KeepInInsertMode |
Získá nebo nastaví hodnotu určující, zda DetailsView má ovládací prvek zůstat v režimu vložení po operaci vložení. |
| Values |
Získá slovník, který obsahuje páry název/hodnota pole pro vložený záznam. |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
