DataKeyArray.CopyTo メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataKeyArray.CopyTo メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した DataKey オブジェクトの配列にこのコレクションのすべての項目をコピーします。コピー操作は、配列内の指定したインデックス位置から開始されます。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub CopyTo ( _
    array As DataKey(), _
    index As Integer _
)

Visual Basic (使用法)

Dim instance As DataKeyArray
Dim array As DataKey()
Dim index As Integer

instance.CopyTo(array, index)

public void CopyTo (
    DataKey[] array,
    int index
)

C++

public:
void CopyTo (
    array<DataKey^>^ array, 
    int index
)

public void CopyTo (
    DataKey[] array, 
    int index
)

JScript

public function CopyTo (
    array : DataKey[], 
    index : int
)

パラメータ

array: コレクションからコピーされた項目の格納先となるインデックス番号が 0 から始まる DataKey オブジェクトの配列。

index: 内容のコピー先として指定された配列内の最初のインデックス。

解説

CopyTo メソッドを使用して、指定した配列にコレクションの項目をコピーします。コピー操作は、指定したインデックス位置から開始されます。項目をコピーすると、その配列を使用してコレクション内の項目にアクセスできるようになります。

メモ
array パラメータには、インデックス番号が 0 から始まる配列を使用する必要があります。

使用例

CopyTo メソッドを使用して、DataKeyArray コレクションの DataKey オブジェクトを DataKey オブジェクトの配列にコピーする方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">

  Sub CustomerGridView_DataBound(ByVal sender
 As Object, ByVal e As
 EventArgs) Handles CustomerGridView.DataBound
          
    ' Use the indexer to retrieve the DataKey object for the 
    ' first record.
    Dim key As DataKey = CustomerGridView.DataKeys(0)

    ' Display the the value of the primary key for the first
    ' record displayed in the GridView control.
    MessageLabel.Text = "The primary key of the first record displayed
 is " & _
      key.Value.ToString() & "."
  
  End Sub
  
</script>

<html>

  <body>
    <form runat="server">
        
      <h3>DataKeyArray Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects
  -->
        <!-- to the Northwind sample database. Use an ASP.NET
     -->
        <!-- expression to retrieve the connection string
 value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address],
 [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
          runat="server"/>
            
      </form>
  </body>
</html>

<%@ Page language="C#" %>

<script runat="server">

  void CustomerGridView_DataBound(Object sender, EventArgs e)
  {           
    // Use the indexer to retrieve the DataKey object for the 
    // first record.
    DataKey key = CustomerGridView.DataKeys[0];

    // Display the the value of the primary key for the first
    // record displayed in the GridView control.
    MessageLabel.Text = "The primary key of the first record displayed is "
 +
      key.Value.ToString() + ".";
  }
  
</script>

<html>

  <body>
    <form runat="server">
        
      <h3>DataKeyArray Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          ondatabound="CustomerGridView_DataBound" 
          runat="server">
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value
   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City],
 [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
          runat="server"/>
            
      </form>
  </body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataKeyArray クラス
DataKeyArray メンバ
System.Web.UI.WebControls 名前空間
DataKey クラス
GridView.DataKeys
Item
GetEnumerator

>> 「DataKeyArray.CopyTo メソッド」を含む用語の索引
DataKeyArray.CopyTo メソッドのページへのリンク


	© 2024 Microsoft.All rights reserved.

DataKeyArray.CopyTo メソッドとは？ わかりやすく解説

DataKeyArray.CopyTo メソッド

急上昇のことば

DataKeyArray.CopyTo メソッドとは？わかりやすく解説