ListView.SelectedDataKey Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение ключа данных выбранного элемента в элементе управления ListView.
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 DataKeyЗначение свойства
Ключ данных для выбранного элемента в элементе управления ListView. Значение по умолчанию — null, указывающее, что на данный момент ни один элемент не выбран.
- Атрибуты
Исключения
Указанные ключи данных для свойства DataKeyNames отсутствуют.
Примеры
В следующем примере показано, как использовать второе поле ключа в качестве параметра в сценарии "главный/подробный". Элемент ListView управления используется для отображения записей из таблицы Product Inventory базы данных AdventureWorks. При выборе элемента в элементе ListView управления сведения о продукте отображаются в другом ListView элементе управления. ProductID — это второе имя ключа в первом ListView элементе управления. Для доступа ко второму ключу код использует значение ProductInventoryListView.SelectedDataKey[1] (ProductInventoryListView.SelectedDataKey(1) в Visual Basic) в PropertyName качестве для ControlParameter объекта . Этот объект параметра, в свою очередь, используется элементом SqlDataSource управления, к которому привязан второй ListView элемент управления.
<%@ 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>
Комментарии
DataKeyNames Если свойство задано, ListView элемент управления создает DataKey объект для каждого элемента в элементе управления , используя значение или значения указанного поля или полей. Затем DataKey объекты добавляются в коллекцию элемента управления DataKeys . DataKeys Обычно свойство используется для извлечения DataKey объекта для определенного элемента данных в элементе ListView управления . Однако если вы хотите получить только DataKey объект выбранного элемента, можно использовать свойство в SelectedDataKey качестве ярлыка.
SelectedDataKey Использование свойства аналогично получению DataKey объекта из DataKeys коллекции по индексу, указанному свойством SelectedIndex . Свойство также можно использовать SelectedValue для получения значения ключа данных для выбранного элемента напрямую.
Если вы создаете ControlParameter объект и хотите получить доступ к ключевому полю, отличному от первого, используйте индексированные SelectedDataKey свойства в PropertyName свойстве ControlParameter объекта .
