DetailsViewInsertedEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные о событии ItemInserted.
public ref class DetailsViewInsertedEventArgs : EventArgspublic class DetailsViewInsertedEventArgs : EventArgstype DetailsViewInsertedEventArgs = class
inherit EventArgsPublic Class DetailsViewInsertedEventArgs
Inherits EventArgs- Наследование
Примеры
В следующем примере кода показано, как использовать DetailsViewInsertedEventArgs объект, переданный обработчику событий для события, ItemInserted чтобы определить, произошло ли исключение во время операции вставки.
<%@ 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>
Комментарии
Элемент DetailsView управления вызывает ItemInserted событие при нажатии кнопки "Вставка" (кнопка с его CommandName свойством "Вставка") в элементе управления, но после DetailsView вставки записи элементом управления. Это позволяет предоставить обработчик событий, выполняющий пользовательскую подпрограмму, например проверку результатов операции вставки при каждом возникновении этого события.
DetailsViewInsertedEventArgs Объект передается обработчику событий, который позволяет определить количество затронутых записей и любые исключения, которые могли возникнуть. Чтобы определить количество записей, затронутых операцией вставки, используйте AffectedRows свойство. Exception Используйте свойство, чтобы определить, произошли ли исключения. Можно также указать, было ли исключение обработано в обработчике событий, задав ExceptionHandled свойство. Если вам нужно получить доступ к значениям вставленной записи, используйте Values это свойство.
По умолчанию элемент управления возвращается в режим, DetailsView указанный DefaultMode свойством после операции вставки. Чтобы сохранить DetailsView элемент управления в режиме вставки, задайте KeepInInsertMode для свойства значение true.
Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".
Список начальных значений свойств для экземпляра DetailsViewDeletedEventArgs класса см. в конструкторе DetailsViewDeletedEventArgs .
Конструкторы
| Имя | Описание |
|---|---|
| DetailsViewInsertedEventArgs(Int32, Exception) |
Инициализирует новый экземпляр класса DetailsViewInsertedEventArgs. |
Свойства
| Имя | Описание |
|---|---|
| AffectedRows |
Возвращает количество строк, затронутых операцией вставки. |
| Exception |
Возвращает исключение (если есть), которое было создано во время операции вставки. |
| ExceptionHandled |
Возвращает или задает значение, указывающее, было ли создано исключение во время операции вставки в обработчик событий. |
| KeepInInsertMode |
Возвращает или задает значение, указывающее, должен ли DetailsView элемент управления оставаться в режиме вставки после операции вставки. |
| Values |
Возвращает словарь, содержащий пары "имя поля"/ "значение" для вставленной записи. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
