Collection<T>.InsertItem メソッド

2013/12/12

Collection<T> の指定のインデックス位置に要素を挿入します。

Namespace:  System.Collections.ObjectModel
アセンブリ:  mscorlib (mscorlib.dll 内)

protected virtual void InsertItem(
	int index,
	T item
)

パラメーター

index
型: System.Int32
item を挿入する位置の、0 から始まるインデックス番号。
item
型: T
挿入するオブジェクト。参照型の場合、null の値を使用できます。

例外条件
ArgumentOutOfRangeException

index が 0 未満です。

または

indexCount より大きくなっています。

Collection<T> は、null を参照型に対して有効な値として受け取り、要素の重複を許可します。

indexCount が等しい場合は、itemCollection<T> の末尾に追加されます。

このメソッドは O(n) 操作です。ここで、nCount です。

このコード例では、Collection<T> ジェネリック クラスの構築型からコレクション クラスを派生させる方法、および InsertItemRemoveItemClearItems、および SetItem の各プロテクト メソッドをオーバーライドして AddInsertRemove、および Clear の各メソッドのカスタム動作や、Item プロパティを設定するためのカスタム動作を提供する方法を示します。

この例で提供されるカスタム動作は、Changed という名前の通知イベントです。これは、各プロテクト メソッドの最後で発生します。Dinosaurs クラスは、Collection<string> (Visual Basic の場合は Collection(Of String)) を継承し、Changed イベントを定義します。イベント情報のために DinosaursChangedEventArgs クラスが使用され、変更の種類を識別するために列挙体が使用されます。

次のコード例では、Collection<T> のいくつかのプロパティおよびメソッドを呼び出して、カスタム イベントの例を示します。


using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Windows.Controls;

public class Dinosaurs : Collection<string>
{
    public event EventHandler<DinosaursChangedEventArgs> Changed;


    protected override void InsertItem(int index, string newItem)
    {
        base.InsertItem(index, newItem);

        EventHandler<DinosaursChangedEventArgs> temp = Changed;
        if (temp != null)
        {
            temp(this, new DinosaursChangedEventArgs(
                ChangeType.Added, newItem, null));
        }
    }

    protected override void SetItem(int index, string newItem)
    {
        string replaced = Items[index];
        base.SetItem(index, newItem);

        EventHandler<DinosaursChangedEventArgs> temp = Changed;
        if (temp != null)
        {
            temp(this, new DinosaursChangedEventArgs(
                ChangeType.Replaced, replaced, newItem));
        }
    }

    protected override void RemoveItem(int index)
    {
        string removedItem = Items[index];
        base.RemoveItem(index);

        EventHandler<DinosaursChangedEventArgs> temp = Changed;
        if (temp != null)
        {
            temp(this, new DinosaursChangedEventArgs(
                ChangeType.Removed, removedItem, null));
        }
    }

    protected override void ClearItems()
    {
        base.ClearItems();

        EventHandler<DinosaursChangedEventArgs> temp = Changed;
        if (temp != null)
        {
            temp(this, new DinosaursChangedEventArgs(
                ChangeType.Cleared, null, null));
        }
    }
}

// Event argument for the Changed event.
//
public class DinosaursChangedEventArgs : EventArgs
{
    public readonly string ChangedItem;
    public readonly ChangeType ChangeType;
    public readonly string ReplacedWith;

    public DinosaursChangedEventArgs(ChangeType change, string item,
        string replacement)
    {
        ChangeType = change;
        ChangedItem = item;
        ReplacedWith = replacement;
    }
}

public enum ChangeType
{
    Added,
    Removed,
    Replaced,
    Cleared
};

public class Example
{

    private static TextBlock _textblock;


    public static void Demo(TextBlock outputBlock)
    {

        Example._textblock = outputBlock;

        Dinosaurs dinosaurs = new Dinosaurs();

        dinosaurs.Changed += ChangedHandler;

        dinosaurs.Add("Psitticosaurus");
        dinosaurs.Add("Caudipteryx");
        dinosaurs.Add("Compsognathus");
        dinosaurs.Add("Muttaburrasaurus");

        Display(dinosaurs);

        outputBlock.Text += String.Format("\nIndexOf(\"Muttaburrasaurus\"): {0}\n",
            dinosaurs.IndexOf("Muttaburrasaurus"));

        outputBlock.Text += String.Format("\nContains(\"Caudipteryx\"): {0}\n",
            dinosaurs.Contains("Caudipteryx"));

        outputBlock.Text += String.Format("\nInsert(2, \"Nanotyrannus\")\n");
        dinosaurs.Insert(2, "Nanotyrannus");

        outputBlock.Text += String.Format("\ndinosaurs[2]: {0}\n", dinosaurs[2]);

        outputBlock.Text += "\ndinosaurs[2] = \"Microraptor\"" + "\n";
        dinosaurs[2] = "Microraptor";

        outputBlock.Text += "\nRemove(\"Microraptor\")\n";
        dinosaurs.Remove("Microraptor");

        outputBlock.Text += "\nRemoveAt(0)\n";
        dinosaurs.RemoveAt(0);

        Display(dinosaurs);
    }

    private static void Display(Collection<string> cs)
    {
        _textblock.Text += "\n";
        foreach (string item in cs)
        {
            _textblock.Text += item + "\n";
        }
    }

    private static void ChangedHandler(object source,
        DinosaursChangedEventArgs e)
    {

        if (e.ChangeType == ChangeType.Replaced)
        {
            _textblock.Text += String.Format("{0} was replaced with {1}\n", e.ChangedItem,
                e.ReplacedWith);
        }
        else if (e.ChangeType == ChangeType.Cleared)
        {
            _textblock.Text += "The dinosaur list was cleared." + "\n";
        }
        else
        {
            _textblock.Text += String.Format("{0} was {1}.\n", e.ChangedItem, e.ChangeType);
        }
    }
}


/* This code example produces the following output:

Psitticosaurus was Added.
Caudipteryx was Added.
Compsognathus was Added.
Muttaburrasaurus was Added.

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

IndexOf("Muttaburrasaurus"): 3

Contains("Caudipteryx"): True

Insert(2, "Nanotyrannus")
Nanotyrannus was Added.

dinosaurs[2]: Nanotyrannus

dinosaurs[2] = "Microraptor"
Nanotyrannus was replaced with Microraptor

Remove("Microraptor")
Microraptor was Removed.

RemoveAt(0)
Psitticosaurus was Removed.

Caudipteryx
Compsognathus
Muttaburrasaurus
 */


Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2014 Microsoft