Homepage Library Lernen Code-Beispiele Downloads Support Community Foren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ListViewInsertedEventArgs-Klasse

.NET Framework 4.5

Stellt Daten für das ItemInserted-Ereignis bereit.

System.Object
  System.EventArgs
    System.Web.UI.WebControls.ListViewInsertedEventArgs

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)
C#
C++
F#
VB
Kopieren 
public class ListViewInsertedEventArgs : EventArgs

Der ListViewInsertedEventArgs-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeListViewInsertedEventArgsInitialisiert eine neue Instanz der ListViewInsertedEventArgs-Klasse.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftAffectedRowsRuft die Anzahl der vom Einfügevorgang betroffenen Zeilen ab.
Öffentliche EigenschaftExceptionRuft die Ausnahme (sofern vorhanden) ab, die während des Einfügevorgangs ausgelöst wurde.
Öffentliche EigenschaftExceptionHandledRuft einen Wert ab, der angibt, ob eine während des Einfügevorgangs ausgelöste Ausnahme im Ereignishandler behandelt wurde, oder legt diesen fest.
Öffentliche EigenschaftKeepInInsertModeRuft einen Wert ab, der angibt, ob die Eingabewerte eines Benutzers für die Steuerelemente in der InsertItemTemplate-Vorlage beibehalten werden, oder legt diesen fest.
Öffentliche EigenschaftValuesRuft Feldname-Wert-Paare für den eingefügten Datensatz ab.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetHashCodeFungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

Das ListView-Steuerelement löst das ItemInserted-Ereignis aus, wenn in der InsertItemTemplate-Vorlage auf eine Schaltfläche zum Einfügen geklickt wird und nachdem der Datensatz in der Datenquelle vom ListView-Steuerelement eingefügt wurde. (Eine Schaltfläche zum Einfügen ist eine Schaltfläche, deren CommandName-Eigenschaft auf "Insert" festgelegt ist.) Das ItemInserted-Ereignis ermöglicht es Ihnen, eine benutzerdefinierte Aktion auszuführen, zum Beispiel für das eingefügte Element automatisch generierte Werte von der Datenbank abzurufen.

Ein ListViewInsertedEventArgs-Objekt wird an die Ereignisbehandlungsmethode übergeben, wodurch Sie die Anzahl der eingefügten Elemente und die möglicherweise aufgetretenen Ausnahmen bestimmen können. Mit der AffectedRows-Eigenschaft können Sie die Anzahl der vom Einfügevorgang betroffenen Elemente bestimmen. Verwenden Sie die Exception-Eigenschaft, um zu ermitteln, ob eine Ausnahme aufgetreten ist. Sie können durch Festlegen der ExceptionHandled-Eigenschaft auch angeben, ob die Ausnahme in der Ereignisbehandlungsmethode behandelt wurde. Wenn Sie über Zugriff auf die Feldwerte des eingefügten Elements verfügen, die an die Datenquelle gesendet wurden, verwenden Sie die Values-Eigenschaft.

In der Standardeinstellung löscht das ListView-Steuerelement die InsertItemTemplate-Vorlage nach dem Einfügevorgang, wodurch Benutzer Werte für ein neues einzufügendes Element hinzufügen können. Wenn während des Einfügevorgangs eine Ausnahme auftritt, können Sie das ListView-Steuerelement im Einfügemodus belassen, indem Sie die KeepInInsertMode-Eigenschaft auf true festlegen. Auf diese Weise wird die InsertItemTemplate-Vorlage erneut an die Werte vom vorherigen Versuch, ein Element einzufügen, gebunden.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz der ListViewInsertedEventArgs-Klasse finden Sie im ListViewInsertedEventArgs-Konstruktor.

Im folgenden Beispiel wird veranschaulicht, wie das ListViewInsertedEventArgs-Objekt verwendet wird, das an den Handler für das ItemInserted-Ereignis übergeben wird.

SicherheitshinweisSicherheitshinweis

In diesem Beispiel ist ein Textfeld für eine Benutzereingabe enthalten. Dies stellt ein potenzielles Sicherheitsrisiko dar. Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

C#
VB
Kopieren 

<%@ 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 ContactsListView_ItemInserted(Object sender, ListViewInsertedEventArgs e)
  {
    if (e.Exception != null)
    {
      if (e.AffectedRows == 0)
      {
        e.KeepInInsertMode = true;
        Message.Text = "An exception occurred inserting the new Contact. " +
          "Please verify your values and try again.";
      }
      else
        Message.Text = "An exception occurred inserting the new Contact. " +
          "Please verify the values in the newly inserted item.";

      e.ExceptionHandled = true;
    }
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    Message.Text = "";
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView.ItemInserted Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListViewItemInserted Example</h3>

      <asp:Label ID="Message"
        ForeColor="Red"          
        runat="server"/>
      <br/>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        OnItemInserted="ContactsListView_ItemInserted"  
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" border="1" runat="server" id="tblContacts" width="640px">
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="PeopleDataPager" PageSize="12">
            <Fields>
              <asp:NextPreviousPagerField 
                ShowFirstPageButton="true" ShowLastPageButton="true"
                FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                NextPageText=" &gt; " PreviousPageText=" &lt; " />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td valign="top">
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
            <td>&nbsp;
              <asp:Label ID="EmailLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <InsertItemTemplate>
          <tr style="background-color:#D3D3D3">
            <td valign="top">
              <asp:Label runat="server" ID="FirstNameLabel" 
                AssociatedControlID="FirstNameTextBox" Text="First Name"/>
              <asp:TextBox ID="FirstNameTextBox" runat="server" 
                Text='<%#Bind("FirstName") %>' /><br />
              <asp:Label runat="server" ID="LastNameLabel" 
                AssociatedControlID="LastNameTextBox" Text="Last Name" />
              <asp:TextBox ID="LastNameTextBox" runat="server" 
                Text='<%#Bind("LastName") %>' /><br />
              <asp:Label runat="server" ID="EmailLabel" 
                AssociatedControlID="EmailTextBox" Text="E-mail" />
              <asp:TextBox ID="EmailTextBox" runat="server" 
                Text='<%#Bind("EmailAddress") %>' />
            </td>
            <td>
              <asp:LinkButton ID="InsertButton" runat="server" 
                CommandName="Insert" Text="Insert" />
            </td>
          </tr>
        </InsertItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName], [EmailAddress] 
          FROM Person.Contact"
        InsertCommand="INSERT INTO Person.Contact
          ([FirstName], [LastName], [EmailAddress], [PasswordHash], [PasswordSalt]) 
          Values(@FirstName, @LastName, @EmailAddress, '', '');
          SELECT @ContactID = SCOPE_IDENTITY()">
        <InsertParameters>
          <asp:Parameter Name="FirstName" />
          <asp:Parameter Name="LastName" />
          <asp:Parameter Name="EmailAddress" />
          <asp:Parameter Name="ContactID" Type="Int32" Direction="Output" />
        </InsertParameters>
      </asp:SqlDataSource>

    </form>
  </body>
</html>

.NET Framework

Unterstützt in: 4.5, 4, 3.5

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Informationen zur Datensicherheit
© 2013 Microsoft. Alle Rechte vorbehalten.