ListView.SelectedDataKey Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar datanyckelvärdet för det markerade objektet i en ListView kontroll.
public:
virtual property System::Web::UI::WebControls::DataKey ^ SelectedDataKey { System::Web::UI::WebControls::DataKey ^ get(); };[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.DataKey SelectedDataKey { get; }[<System.ComponentModel.Browsable(false)>]
member this.SelectedDataKey : System.Web.UI.WebControls.DataKeyPublic Overridable ReadOnly Property SelectedDataKey As DataKeyEgenskapsvärde
Datanyckeln för det markerade objektet i en ListView kontroll. Standardvärdet är null, vilket anger att inget objekt är markerat för närvarande.
- Attribut
Undantag
Inga datanycklar anges i egenskapen DataKeyNames .
Exempel
I följande exempel visas hur du använder det andra nyckelfältet som en parameter i ett huvud-/detaljscenario. En ListView kontroll används för att visa poster från tabellen Produktinventering i AdventureWorks-databasen. När ett objekt har valts i ListView kontrollen visas information om produkten i en annan ListView kontroll. ProductID är det andra nyckelnamnet i den första ListView kontrollen. För att komma åt den andra nyckeln använder koden värdet ProductInventoryListView.SelectedDataKey[1] (ProductInventoryListView.SelectedDataKey(1) i Visual Basic) som PropertyName för objektet ControlParameter. Det här parameterobjektet används i sin tur av den SqlDataSource kontroll som den andra ListView kontrollen är bunden till.
<%@ 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 ProductInventoryListView_PagePropertiesChanging(object sender,
PagePropertiesChangingEventArgs e)
{
ProductInventoryListView.SelectedIndex = -1;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView SelectedDataKey Example</title>
<style type="text/css">
.header
{
border: 1px solid #008080;
background-color: #008080;
color: White;
}
.item td { border: 1px solid #008080; }
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView SelectedDataKey Example</h3>
<asp:ListView runat="server"
ID="ProductInventoryListView"
DataSourceID="ProductInventoryDataSource"
DataKeyNames="LocationID,ProductID"
OnPagePropertiesChanging="ProductInventoryListView_PagePropertiesChanging">
<LayoutTemplate>
<b>Product Inventory</b>
<br />
<table width="400px" runat="server" id="tblProducts">
<tr class="header" runat="server">
<th runat="server"> </th>
<th runat="server">Product ID</th>
<th runat="server">Location ID</th>
<th runat="server">Shelf</th>
<th runat="server">Bin</th>
<th runat="server">Quantity</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="ProductInventoryPager">
<Fields>
<asp:NextPreviousPagerField ShowFirstPageButton="true"
ShowLastPageButton="true" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr class="item" runat="server">
<td>
<asp:ImageButton runat="server"
ID="SelectButton"
Width="15"
Height="15"
ImageUrl="~/images/select.jpg"
CommandName="Select" />
</td>
<td>
<asp:Label runat="server" ID="ProductIDLabel" Text='<%#Eval("ProductID") %>' />
</td>
<td>
<asp:Label runat="server" ID="LocationIDLabel" Text='<%#Eval("LocationID") %>' />
</td>
<td>
<asp:Label runat="server" ID="ShelfLabel" Text='<%#Eval("Shelf") %>' />
</td>
<td>
<asp:Label runat="server" ID="BinLabel" Text='<%#Eval("Bin") %>' />
</td>
<td>
<asp:Label runat="server" ID="QuantityLabel" Text='<%#Eval("Quantity") %>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<br /><br />
<asp:ListView runat="server" ID="ProductListView"
DataSourceID="ProductDataSource">
<LayoutTemplate>
<b>Product Details</b>
<table runat="server" id="tblDetails">
<tr runat="server" id="itemPlaceholder" />
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td class="header">Product ID:</td>
<td>
<asp:Label runat="server" ID="ProductLabel" Text='<%#Eval("ProductID") %>' />
</td>
</tr>
<tr runat="server">
<td class="header">Name:</td>
<td>
<asp:Label runat="server" ID="NameLabel" Text='<%#Eval("Name") %>' />
</td>
</tr>
<tr runat="server">
<td class="header">Color:</td>
<td>
<asp:Label runat="server" ID="ColorLabel" Text='<%#Eval("Color") %>' />
</td>
</tr>
<tr runat="server">
<td class="header">Price:</td>
<td>
<asp:Label runat="server" ID="ListPriceLabel" Text='<%#Eval("ListPrice", "{0:c}") %>' />
</td>
</tr>
</ItemTemplate>
</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="ProductInventoryDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ProductID], [LocationID], [Shelf], [Bin], [Quantity]
FROM Production.ProductInventory">
</asp:SqlDataSource>
<asp:SqlDataSource ID="ProductDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ProductID], [Name], [Color], [ListPrice], [ProductNumber]
FROM Production.Product
WHERE ProductID = @ProductID
ORDER BY [Name]">
<SelectParameters>
<asp:ControlParameter Name="ProductID"
DefaultValue="0"
ControlID="ProductInventoryListView"
PropertyName="SelectedDataKey[1]" />
</SelectParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub ProductInventoryListView_PagePropertiesChanging(ByVal sender As Object, _
ByVal e As PagePropertiesChangingEventArgs)
ProductInventoryListView.SelectedIndex = -1
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView SelectedDataKey Example</title>
<style type="text/css">
.header
{
border: 1px solid #008080;
background-color: #008080;
color: White;
}
.item td { border: 1px solid #008080; }
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView SelectedDataKey Example</h3>
<asp:ListView runat="server"
ID="ProductInventoryListView"
DataSourceID="ProductInventoryDataSource"
DataKeyNames="LocationID,ProductID"
OnPagePropertiesChanging="ProductInventoryListView_PagePropertiesChanging">
<LayoutTemplate>
<b>Product Inventory</b>
<br />
<table width="400px" runat="server" id="tblProducts">
<tr class="header" runat="server">
<th runat="server"> </th>
<th runat="server">Product ID</th>
<th runat="server">Location ID</th>
<th runat="server">Shelf</th>
<th runat="server">Bin</th>
<th runat="server">Quantity</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="ProductInventoryPager">
<Fields>
<asp:NextPreviousPagerField ShowFirstPageButton="true"
ShowLastPageButton="true" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr class="item" runat="server">
<td>
<asp:ImageButton runat="server"
ID="SelectButton"
Width="15"
Height="15"
ImageUrl="~/images/select.jpg"
CommandName="Select" />
</td>
<td>
<asp:Label runat="server" ID="ProductIDLabel" Text='<%#Eval("ProductID") %>' />
</td>
<td>
<asp:Label runat="server" ID="LocationIDLabel" Text='<%#Eval("LocationID") %>' />
</td>
<td>
<asp:Label runat="server" ID="ShelfLabel" Text='<%#Eval("Shelf") %>' />
</td>
<td>
<asp:Label runat="server" ID="BinLabel" Text='<%#Eval("Bin") %>' />
</td>
<td>
<asp:Label runat="server" ID="QuantityLabel" Text='<%#Eval("Quantity") %>' />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<br /><br />
<asp:ListView runat="server" ID="ProductListView"
DataSourceID="ProductDataSource">
<LayoutTemplate>
<b>Product Details</b>
<table runat="server" id="tblDetails">
<tr runat="server" id="itemPlaceholder" />
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td class="header">Product ID:</td>
<td>
<asp:Label runat="server" ID="ProductLabel" Text='<%#Eval("ProductID") %>' />
</td>
</tr>
<tr runat="server">
<td class="header">Name:</td>
<td>
<asp:Label runat="server" ID="NameLabel" Text='<%#Eval("Name") %>' />
</td>
</tr>
<tr runat="server">
<td class="header">Color:</td>
<td>
<asp:Label runat="server" ID="ColorLabel" Text='<%#Eval("Color") %>' />
</td>
</tr>
<tr runat="server">
<td class="header">Price:</td>
<td>
<asp:Label runat="server" ID="ListPriceLabel" Text='<%#Eval("ListPrice", "{0:c}") %>' />
</td>
</tr>
</ItemTemplate>
</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="ProductInventoryDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ProductID], [LocationID], [Shelf], [Bin], [Quantity]
FROM Production.ProductInventory">
</asp:SqlDataSource>
<asp:SqlDataSource ID="ProductDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [ProductID], [Name], [Color], [ListPrice], [ProductNumber]
FROM Production.Product
WHERE ProductID = @ProductID
ORDER BY [Name]">
<SelectParameters>
<asp:ControlParameter Name="ProductID"
DefaultValue="0"
ControlID="ProductInventoryListView"
PropertyName="SelectedDataKey[1]" />
</SelectParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
Kommentarer
När egenskapen DataKeyNames har angetts ListView skapar kontrollen ett DataKey objekt för varje objekt i kontrollen med hjälp av värdet eller värdena för det angivna fältet eller fälten. Objekten DataKey läggs sedan till i kontrollens DataKeys samling. Normalt används egenskapen DataKeys för att hämta DataKey objektet för ett specifikt dataobjekt i ListView kontrollen. Men om du bara DataKey vill hämta objektet för det markerade objektet kan du använda SelectedDataKey egenskapen som en genväg.
Att använda egenskapen SelectedDataKey är detsamma som att DataKey hämta objektet från DataKeys samlingen i det index som anges av egenskapen SelectedIndex . Du kan också använda SelectedValue egenskapen för att hämta datanyckelvärdet för det markerade objektet direkt.
Om du skapar ett ControlParameter objekt och vill komma åt ett annat nyckelfält än det första fältet använder du den indexerade SelectedDataKey egenskapen i PropertyName objektets ControlParameter egenskap.