ListViewItemEventArgs ListViewItemEventArgs ListViewItemEventArgs ListViewItemEventArgs Class

定義

ItemCreated イベントと ItemDataBound イベントにデータを提供します。Provides data for the ItemCreated and ItemDataBound events.

public ref class ListViewItemEventArgs : EventArgs
public class ListViewItemEventArgs : EventArgs
type ListViewItemEventArgs = class
    inherit EventArgs
Public Class ListViewItemEventArgs
Inherits EventArgs
継承
ListViewItemEventArgsListViewItemEventArgsListViewItemEventArgsListViewItemEventArgs

次の例は、使用する方法を示します、ListViewItemEventArgsデータにバインドされている項目のプロパティにアクセスするオブジェクト。The following example shows how to use the ListViewItemEventArgs object to access the properties of the item that is being bound to data.


<%@ 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">

    // <Snippet2>
    protected void ContactsListView_ItemDataBound(object sender, ListViewItemEventArgs e)
    {
        Label EmailAddressLabel;
        if (e.Item.ItemType == ListViewItemType.DataItem)
        {
            // Display the email address in italics.
            EmailAddressLabel = (Label)e.Item.FindControl("EmailAddressLabel");
            EmailAddressLabel.Font.Italic = true;

            System.Data.DataRowView rowView = e.Item.DataItem as System.Data.DataRowView;
            string currentEmailAddress = rowView["EmailAddress"].ToString();
            if (currentEmailAddress == "orlando0@adventure-works.com")
            {
                EmailAddressLabel.Font.Bold = true;
            }
        }
    }
    // </Snippet2>
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>ListView ItemDataBound Example</title>
</head>
<body style="font: 10pt Trebuchet MS">
    <form id="form1" runat="server">
    <h3>
        ListView ItemDataBound Example</h3>
    <asp:ListView ID="ContactsListView" DataSourceID="ContactsDataSource" ConvertEmptyStringToNull="true"
        OnItemDataBound="ContactsListView_ItemDataBound" runat="server">
        <LayoutTemplate>
            <table cellpadding="2" width="680px" border="0">
                <tr style="background-color: #ADD8E6" runat="server">
                    <th runat="server">
                        First Name
                    </th>
                    <th runat="server">
                        Last Name
                    </th>
                    <th runat="server">
                        Email Address
                    </th>
                </tr>
                <tr runat="server" id="itemPlaceholder" />
            </table>
            <asp:DataPager runat="server" ID="PeopleDataPager" PageSize="12">
                <Fields>
                    <asp:NumericPagerField ButtonCount="10" />
                </Fields>
            </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
            <tr style="background-color: #CAEEFF" runat="server">
                <td>
                    <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
                </td>
                <td>
                    <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
                </td>
                <td>
                    <asp:Label ID="EmailAddressLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
                </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="ContactsDataSource" runat="server" ConnectionString="<%$ ConnectionStrings:AdventureWorksConnectionString %>"
        SelectCommand="SELECT FirstName, LastName, EmailAddress FROM SalesLT.Customer">
    </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">

    ' <Snippet2>
    Protected Sub ContactsListView_ItemDataBound(ByVal sender As Object, _
                                                 ByVal e As ListViewItemEventArgs)
  
        If e.Item.ItemType = ListViewItemType.DataItem Then
            ' Display the email address in italics.
            Dim EmailAddressLabel As Label = _
              CType(e.Item.FindControl("EmailAddressLabel"), Label)
            EmailAddressLabel.Font.Italic = True

            Dim rowView As System.Data.DataRowView
            rowView = CType(e.Item.DataItem, System.Data.DataRowView)
            Dim currentEmailAddress As String = rowView("EmailAddress").ToString()
            If currentEmailAddress = "orlando0@adventure-works.com" Then
                EmailAddressLabel.Font.Bold = True
            End If
        End If
        
    End Sub
    ' </Snippet2>

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>ListView ItemDataBound Example</title>
</head>
<body style="font: 10pt Trebuchet MS">
    <form id="form1" runat="server">
    <h3>
        ListView ItemDataBound Example</h3>
    <asp:ListView ID="ContactsListView" DataSourceID="ContactsDataSource" ConvertEmptyStringToNull="true"
        OnItemDataBound="ContactsListView_ItemDataBound" runat="server">
        <layouttemplate>
          <table cellpadding="2" width="680px" border="0">
            <tr style="background-color: #ADD8E6" runat="server">
                <th runat="server">First Name</th>
                <th runat="server">Last Name</th>
                <th runat="server">Email Address</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="PeopleDataPager" PageSize="12">
            <Fields>
              <asp:NumericPagerField ButtonCount="10" /> 
            </Fields>
          </asp:DataPager>
        </layouttemplate>
        <itemtemplate>
          <tr style="background-color: #CAEEFF" runat="server">
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
            <td>
              <asp:Label ID="EmailAddressLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
            </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="ContactsDataSource" runat="server" ConnectionString="<%$ ConnectionStrings:AdventureWorksConnectionString %>"
        SelectCommand="SELECT FirstName, LastName, EmailAddress FROM SalesLT.Customer">
    </asp:SqlDataSource>
    </form>
</body>
</html>

注釈

前に、ListViewコントロールを表示できる、ListViewItemコントロール内の各項目のオブジェクトを作成する必要があります。Before the ListView control can be rendered, a ListViewItem object must be created for each item in the control. ItemCreatedイベントは毎回を内の項目、ListViewコントロールが作成されます。The ItemCreated event is raised every time that an item in the ListView control is created. これにより、項目にカスタム コンテンツを追加するなど、項目が作成されるたびに、カスタム ルーチンを実行するイベント処理メソッドを提供できます。This enables you to provide an event-handling method that performs a custom routine whenever an item is created, such as adding custom content to an item.

同様に、前に、ListViewコントロールを表示できる、コントロール内のすべての項目は、データ ソースのレコードにバインドする必要があります。Similarly, before the ListView control can be rendered, every item in the control must be bound to a record in the data source. ItemDataBound項目イベントが発生します (によって表される、ListViewItemオブジェクト) データには、バインド、ListViewコントロール。The ItemDataBound event is raised when an item (represented by a ListViewItem object) is bound to data in the ListView control. これにより、項目が表示される前に、データの値を変更するなどのデータにバインドされたときに、カスタム ルーチンを実行することができます。This enables you to perform a custom routine whenever an item is bound to data, such as modifying the values of the data before they are displayed.

AListViewItemEventArgsオブジェクトがイベントを発生させた項目のプロパティにアクセスすることができるイベント処理メソッドに渡されます。A ListViewItemEventArgs object is passed to the event-handling method, which enables you to access the properties of the item that raised the event. どの項目の種類 (データ項目、空の項目または項目の挿入) が作成されるかを調べるには、ItemTypeのプロパティ、ListViewItemオブジェクト。To determine which item type (data item, empty item, or insert item) is being created, use the ItemType property of the ListViewItem object.

インスタンスの初期プロパティ値の一覧についてはListViewItemEventArgsを参照してください、ListViewItemEventArgsコンス トラクター。For a list of initial property values for an instance of ListViewItemEventArgs, see the ListViewItemEventArgs constructor.

コンストラクター

ListViewItemEventArgs(ListViewItem) ListViewItemEventArgs(ListViewItem) ListViewItemEventArgs(ListViewItem) ListViewItemEventArgs(ListViewItem)

ListViewItemEventArgs クラスの新しいインスタンスを初期化します。Initializes a new instance of the ListViewItemEventArgs class.

プロパティ

Item Item Item Item

作成される項目またはデータにバインドされる項目を取得します。Gets the item that is being created or bound to data.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください