EditorPartCollection.CopyTo メソッド

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

EditorPartCollection.CopyTo メソッド

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

コレクションを EditorPart コントロールの配列にコピーします。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As EditorPartCollection
Dim array As EditorPart()
Dim index As Integer

instance.CopyTo(array, index)

C#

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

C++

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

J#

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

JScript

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

パラメータ

array

コピーしたコントロールのコレクションを含める EditorPart。

index

コレクションの内容を配置する位置を示す、配列内の開始点。

解説

CopyTo メソッドは、EditorPartCollection オブジェクトの EditorPart コントロール、またはそれらのコントロールのサブセットかスーパーセットを格納できるカスタム配列を作成する場合に便利です。

使用例

CopyTo メソッドを使用して、EditorPart コントロールのカスタム配列を作成する方法を次のコード例に示します。例の実行に必要なコード全体については、EditorPartCollection クラスの概要で「例」を参照してください。

Button1_Click イベント内のコードは、EditorPart コントロールの配列を作成し、LayoutEditorPart1 コントロールを配列に追加します。次に、CopyTo メソッドを使用して、コントロールを EditorPartCollection オブジェクトから配列にコピーします。

Visual Basic

<script runat="server">

  Protected Sub Button1_Click(ByVal
 sender As Object, _
    ByVal e As EventArgs)
    
    Dim list As New ArrayList(2)
    list.Add(AppearanceEditorPart1)
    list.Add(PropertyGridEditorPart1)
    ' Pass an ICollection object to the constructor.
    Dim myParts As New EditorPartCollection(list)
    Dim editor As EditorPart
    For Each editor In myParts
      editor.BackColor = System.Drawing.Color.LightBlue
      editor.Description = "My " + editor.DisplayTitle
 + " editor."
    Next editor
    
    ' Use the IndexOf property to locate an EditorPart control.
    Dim propertyGridPart As Integer
 = _
      myParts.IndexOf(PropertyGridEditorPart1)
    myParts(propertyGridPart).ChromeType = PartChromeType.TitleOnly
    
    ' Use the Contains method to see if an EditorPart exists.
    If Not myParts.Contains(LayoutEditorPart1)
 Then
      LayoutEditorPart1.BackColor = System.Drawing.Color.LightYellow
    End If
    
    ' Use the CopyTo method to create an array of EditorParts.
    Dim partArray(2) As EditorPart
    partArray(0) = LayoutEditorPart1
    myParts.CopyTo(partArray, 1)
    Label1.Text = "<h3>EditorParts in Custom Array</h3>"
    Dim ePart As EditorPart
    For Each ePart In partArray
      Label1.Text += ePart.Title + "<br />"
    Next ePart

  End Sub

</script>

C#

<script runat="server">

  protected void Button1_Click(object sender,
 EventArgs e)
  {
    ArrayList list = new ArrayList(2);
    list.Add(AppearanceEditorPart1);
    list.Add(PropertyGridEditorPart1);
    // Pass an ICollection object to the constructor.
    EditorPartCollection myParts = new EditorPartCollection(list);
    foreach (EditorPart editor in myParts)
    {
      editor.BackColor = System.Drawing.Color.LightBlue;
      editor.Description = "My " + editor.DisplayTitle + " editor.";
    }

    // Use the IndexOf property to locate an EditorPart control.
    int propertyGridPart = myParts.IndexOf(PropertyGridEditorPart1);
    myParts[propertyGridPart].ChromeType = PartChromeType.TitleOnly;

    // Use the Contains method to see if an EditorPart exists.
    if(!myParts.Contains(LayoutEditorPart1))
      LayoutEditorPart1.BackColor = System.Drawing.Color.LightYellow;
    
    // Use the CopyTo method to create an array of EditorParts.
    EditorPart[] partArray = new EditorPart[3];
    partArray[0] = LayoutEditorPart1;
    myParts.CopyTo(partArray,1);
    Label1.Text = "<h3>EditorParts in Custom Array</h3>";
    foreach (EditorPart ePart in partArray)
    {
      Label1.Text += ePart.Title + "<br />";
    }

  }

</script>

ブラウザでページを読み込む場合、[Display Mode] ドロップダウン リスト コントロールの [編集] を選択することにより、ページを編集モードに切り替えることができます。TextDisplayWebPart コントロールのタイトル バーで動詞メニュー (下向きの矢印) をクリックし、[編集] をクリックすることにより、コントロールを編集できます。編集中のユーザー インターフェイス (UI) が表示状態の場合、すべての EditorPart コントロールを表示できます。[Create EditorPartCollection] ボタンをクリックすると、カスタム配列内のすべてのコントロールのタイトルがページの末尾付近に一覧表示されるのを確認できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
EditorPartCollection クラス
EditorPartCollection メンバ
System.Web.UI.WebControls.WebParts 名前空間
その他の技術情報
ASP.NET Web パーツ ページ