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.

ListView.SelectedItemTemplate-Eigenschaft

.NET Framework 4.5

Andere Versionen

Ruft den benutzerdefinierten Inhalt des ausgewählten Elements in einem ListView-Steuerelement ab oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)

Syntax

C++

[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(ListViewDataItem), BindingDirection.TwoWay)]
public virtual ITemplate SelectedItemTemplate { get; set; }

ASP.NET

<asp:ListView>
	<SelectedItemTemplate>ITemplate</SelectedItemTemplate>
</asp:ListView>

Eigenschaftswert

Typ: System.Web.UI.ITemplate
Ein Objekt, das den benutzerdefinierten Inhalt für das ausgewählte Element in einem ListView-Steuerelement enthält. Der Standardwert ist null und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Hinweise

Definieren Sie mithilfe der SelectedItemTemplate-Eigenschaft eine benutzerdefinierte Benutzeroberfläche (UI) für das ausgewählte Element in einem ListView-Steuerelement. Die SelectedItemTemplate wird meist verwendet, um das ausgewählte Element von den anderen angezeigten Elementen zu unterscheiden. SelectedItemTemplate wird anstelle der ItemTemplate-Vorlage für das ausgewählte Element gerendert.

Wenn Sie die benutzerdefinierte Vorlage deklarativ angeben möchten, fügen Sie ein SelectedItemTemplate-Element im ListView-Steuerelement hinzu. Anschließend können Sie dem SelectedItemTemplate-Element den Inhalt der Vorlage hinzufügen. Verwenden Sie einen Datenbindungsausdruck, um die Feldwerte der Datenquelle anzuzeigen, die an das Steuerelement gebunden ist. Weitere Informationen finden Sie unter Data-Binding Expression Syntax.

Sie können der SelectedItemTemplate auch Schaltflächen hinzufügen. Um Schaltflächen zu erstellen, über die die integrierten Vorgänge zum Löschen und Bearbeiten ausgeführt werden können, fügen Sie der Vorlage ein Schaltflächen-Steuerelement hinzu, und legen Sie dessen CommandName-Eigenschaft auf einen der in der folgenden Tabelle aufgeführten Werte fest.

Schaltflächentyp	CommandName-Wert
Delete	"Delete"
Edit	"Edit"

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie mit der SelectedItemTemplate-Eigenschaft der Inhalt des im ListView-Steuerelement ausgewählten Elements bestimmt wird.


<%@ 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">
  protected void CategoriesListView_OnItemDeleting(object sender, ListViewDeleteEventArgs e)
  {
    if (SubCategoriesGridView.Rows.Count > 0)
    {
      MessageLabel.Text = "You cannot delete a category that has sub-categories.";
      e.Cancel = true;
    }
  }

  protected void Page_Load()
  {
    MessageLabel.Text = String.Empty;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>Subcategories List</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <b>Categories</b>
      <br />

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

      <asp:ListView runat="server" 
        ID="CategoriesListView"
        OnItemDeleting="CategoriesListView_OnItemDeleting"
        DataSourceID="CategoriesDataSource" 
        DataKeyNames="ProductCategoryID">
        <LayoutTemplate>
          <table runat="server" id="tblCategories" 
                 cellspacing="0" cellpadding="1" width="440px" border="1">
            <tr id="itemPlaceholder" runat="server"></tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label runat="server" ID="NameLabel" Text='<%#Eval("Name") %>' />
            </td>
            <td style="width:40px">
              <asp:LinkButton runat="server" ID="SelectCategoryButton" 
                Text="Select" CommandName="Select" />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr runat="server" style="background-color:#90EE90">
            <td>
              <asp:Label runat="server" ID="NameLabel" Text='<%#Eval("Name") %>' />
            </td>
            <td style="width:40px">
              <asp:LinkButton runat="server" ID="SelectCategoryButton" 
                Text="Delete" CommandName="Delete" />
            </td>
          </tr>
        </SelectedItemTemplate>
      </asp:ListView>

      <br />

      <b>Subcategories</b>
      <asp:GridView runat="server" ID="SubCategoriesGridView" Width="300px"
           DataSourceID="SubCategoriesDataSource" DataKeyNames="ProductSubcategoryID" 
           AutoGenerateColumns="True" />

      <!-- 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="CategoriesDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ProductCategoryID], [Name]
                       FROM Production.ProductCategory">
      </asp:SqlDataSource>
      <asp:SqlDataSource ID="SubCategoriesDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ProductSubcategoryID], [Name]
                       FROM Production.ProductSubcategory
                       WHERE ProductCategoryID = @ProductCategoryID
                       ORDER BY [Name]">
          <SelectParameters>
            <asp:ControlParameter Name="ProductCategoryID" DefaultValue="0"
                 ControlID="CategoriesListView" PropertyName="SelectedValue"  />
          </SelectParameters>
      </asp:SqlDataSource>
    </form>
  </body>
</html>

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5

Plattformen

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.

Siehe auch