ArrayList

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

ArrayList クラス

必要に応じてサイズが動的に増加する配列を使用して、IList インターフェイスを実装します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class ArrayList
    Implements IList, ICollection, IEnumerable, ICloneable

Visual Basic (使用法)

Dim instance As ArrayList

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class ArrayList : IList, ICollection,
 IEnumerable, 
    ICloneable

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class ArrayList : IList, ICollection,
 IEnumerable, 
    ICloneable

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class ArrayList implements IList, ICollection,
 
    IEnumerable, ICloneable

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class ArrayList implements IList, ICollection,
 
    IEnumerable, ICloneable

解説

ArrayList が並べ替えられることは保証されていません。ArrayList を並べ替える必要のある操作 (BinarySearch など) を実行する前に、ArrayList を並べ替える必要があります。

ArrayList の容量は、ArrayList が保持できる要素数になります。ArrayList の既定の初期量は 0 です。ArrayList に要素を追加すると、必要に応じて、再割り当てによって容量が自動的に増加します。容量を減らすには、TrimToSize を呼び出すか、Capacity プロパティを明示的に設定します。

このコレクション内の要素は、整数インデックスを使用してアクセスできます。このコレクションのインデックスは 0 から始まります。

ArrayList は、null 参照 (Visual Basic では Nothing) を有効な値として受け取り、要素の重複を許可します。

使用例

ArrayList を作成および初期化する方法と、その値を出力する方法を次のコード例に示します。

Visual Basic

Imports System
Imports System.Collections
Imports Microsoft.VisualBasic

Public Class SamplesArrayList    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new ArrayList.
        Dim myAL As New
 ArrayList()
        myAL.Add("Hello")
        myAL.Add("World")
        myAL.Add("!")
        
        ' Displays the properties and values of the ArrayList.
        Console.WriteLine("myAL")
        Console.WriteLine("    Count:    {0}", myAL.Count)
        Console.WriteLine("    Capacity: {0}", myAL.Capacity)
        Console.Write("    Values:")
        PrintValues(myAL)
    End Sub

    Public Shared Sub PrintValues(myList
 As IEnumerable)
        Dim obj As [Object]
        For Each obj In
  myList
            Console.Write("   {0}", obj)
        Next obj
        Console.WriteLine()
    End Sub 'PrintValues

End Class


' This code produces output similar to the following:
' 
' myAL
'     Count:    3
'     Capacity: 4
'     Values:   Hello   World   !

C#

using System;
using System.Collections;
public class SamplesArrayList  {

   public static void Main()
  {

      // Creates and initializes a new ArrayList.
      ArrayList myAL = new ArrayList();
      myAL.Add("Hello");
      myAL.Add("World");
      myAL.Add("!");

      // Displays the properties and values of the ArrayList.
      Console.WriteLine( "myAL" );
      Console.WriteLine( "    Count:    {0}", myAL.Count );
      Console.WriteLine( "    Capacity: {0}", myAL.Capacity );
      Console.Write( "    Values:" );
      PrintValues( myAL );
   }

   public static void PrintValues(
 IEnumerable myList )  {
      foreach ( Object obj in myList )
         Console.Write( "   {0}", obj );
      Console.WriteLine();
   }

}


/* 
This code produces output similar to the following:

myAL
    Count:    3
    Capacity: f
    Values:   Hello   World   !

*/

C++

using namespace System;
using namespace System::Collections;
void PrintValues( IEnumerable^ myList );
int main()
{
   
   // Creates and initializes a new ArrayList.
   ArrayList^ myAL = gcnew ArrayList;
   myAL->Add( "Hello" );
   myAL->Add( "World" );
   myAL->Add( "!" );
   
   // Displays the properties and values of the ArrayList.
   Console::WriteLine( "myAL" );
   Console::WriteLine( "    Count:    {0}", myAL->Count );
   Console::WriteLine( "    Capacity: {0}", myAL->Capacity );
   Console::Write( "    Values:" );
   PrintValues( myAL );
}

void PrintValues( IEnumerable^ myList )
{
   IEnumerator^ myEnum = myList->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ obj = safe_cast<Object^>(myEnum->Current);
      Console::Write( "   {0}", obj );
   }

   Console::WriteLine();
}

/* 
This code produces output similar to the following:

myAL
    Count:    3
    Capacity: 4
    Values:   Hello   World   !

*/

J#

import System.*;
import System.Collections.*;

public class SamplesArrayList
{
    public static void main(String[]
 args)
    {
        // Creates and initializes a new ArrayList.
        ArrayList myAL = new ArrayList();

        myAL.Add("Hello");
        myAL.Add("World");
        myAL.Add("!");

        // Displays the properties and values of the ArrayList.
        Console.WriteLine("myAL");
        Console.WriteLine("    Count:    {0}", (Int32)myAL.get_Count());
        Console.WriteLine("    Capacity: {0}", (Int32)myAL.get_Capacity());
        Console.Write("    Values:");
        PrintValues(myAL);
    } //main

    public static void PrintValues(IEnumerable
 myList)
    {
        IEnumerator objMyEnum = myList.GetEnumerator();
        while (objMyEnum.MoveNext()) {
            Object obj = objMyEnum.get_Current();
            Console.Write("   {0}", obj);
        }
        Console.WriteLine();
    } //PrintValues
} //SamplesArrayList 
/* 
 This code produces output similar to the following:
 
 myAL
     Count:    3
     Capacity: 4
     Values:   Hello   World   !

 */

JScript

import System;
import System.Collections;

// Creates and initializes a new ArrayList.
var myAL : ArrayList = new ArrayList();
myAL.Add("Hello");
myAL.Add("World");
myAL.Add("!");

// Displays the properties and values of the ArrayList.
Console.WriteLine( "myAL" );
Console.WriteLine( "\tCount:    {0}", myAL.Count );
Console.WriteLine( "\tCapacity: {0}", myAL.Capacity );
Console.Write( "\tValues:" );
PrintValues( myAL );

 
function PrintValues( myList : IEnumerable )  {
   var myEnumerator : System.Collections.IEnumerator = myList.GetEnumerator();
   while ( myEnumerator.MoveNext() )
      Console.Write( "\t{0}", myEnumerator.Current );
   Console.WriteLine();
}
 /* 
 This code produces output similar to the following:
 
 myAL
     Count:    3
     Capacity: 4
     Values:    Hello    World    !
 */

継承階層

System.Object
  System.Collections.ArrayList
     System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバは、スレッド セーフです。すべてのインスタンス メンバがスレッド セーフになるかどうかは保証されていません。

ArrayList では、複数の読み込み操作が同時に発生しても、コレクションが変更されない限り問題ありません。ArrayList を確実にスレッド セーフにするためには、すべての操作を Synchronized メソッドから返されるラッパー経由で実行する必要があります。

コレクションの列挙処理は、本質的にはスレッド セーフな処理ではありません。コレクションが同期されている場合でも、他のスレッドがそのコレクションを変更する可能性はあり、そのような状況が発生すると列挙子は例外をスローします。列挙処理を確実にスレッド セーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ArrayList メンバ
System.Collections 名前空間
IList
System.Collections.Generic.List
その他の技術情報
カルチャを認識しないコレクションの操作の実行

ArrayList コンストラクタ ()

空で、既定の初期量を備えた、ArrayList クラスの新しいインスタンスを初期化します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ArrayList

C#

public ArrayList ()

C++

public:
ArrayList ()

J#

public ArrayList ()

JScript

public function ArrayList ()

解説

ArrayList の容量は、ArrayList が保持できる要素数になります。ArrayList に要素を追加すると、必要に応じて、内部の配列の再割り当てによって容量が自動的に増加します。

コレクションのサイズを推定できる場合は、初期量を指定すると、ArrayList に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

このコンストラクタは O(1) 操作です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ArrayList クラス
ArrayList メンバ
System.Collections 名前空間
Capacity

ArrayList コンストラクタ (ICollection)

指定したコレクションからコピーした要素を格納し、コピーされる要素の数と同じ初期量を備えた、ArrayList クラスの新しいインスタンスを初期化します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    c As ICollection _
)

Visual Basic (使用法)

Dim c As ICollection

Dim instance As New ArrayList(c)

C#

public ArrayList (
    ICollection c
)

C++

public:
ArrayList (
    ICollection^ c
)

J#

public ArrayList (
    ICollection c
)

JScript

public function ArrayList (
    c : ICollection
)

パラメータ

c

新しいリストに要素が追加された ICollection。

例外

例外の種類	条件
ArgumentNullException	c が null 参照 (Visual Basic では Nothing) です。

解説

ArrayList の容量は、ArrayList が保持できる要素数になります。ArrayList に要素を追加すると、必要に応じて、内部の配列の再割り当てによって容量が自動的に増加します。

コレクションのサイズを推定できる場合は、初期量を指定すると、ArrayList に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

要素は、ICollection の IEnumerator によって読み取られる順序と同じ順序で、ArrayList にコピーされます。

このコンストラクタは O(n) 操作です (n は c 内の要素数)。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ArrayList クラス
ArrayList メンバ
System.Collections 名前空間
ICollection
Capacity

ArrayList コンストラクタ (Int32)

空で、指定した初期量を備えた、ArrayList クラスの新しいインスタンスを初期化します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    capacity As Integer _
)

Visual Basic (使用法)

Dim capacity As Integer

Dim instance As New ArrayList(capacity)

C#

public ArrayList (
    int capacity
)

C++

public:
ArrayList (
    int capacity
)

J#

public ArrayList (
    int capacity
)

JScript

public function ArrayList (
    capacity : int
)

パラメータ

capacity

新しいリストに格納できる要素の数。

例外

例外の種類	条件
ArgumentOutOfRangeException	capacity が 0 未満です。

解説

ArrayList の容量は、ArrayList が保持できる要素数になります。ArrayList に要素を追加すると、必要に応じて、内部の配列の再割り当てによって容量が自動的に増加します。

コレクションのサイズを推定できる場合は、初期量を指定すると、ArrayList に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

このコンストラクタは O(n) 操作です (n はcapacity)。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ArrayList クラス
ArrayList メンバ
System.Collections 名前空間
Capacity

ArrayList コンストラクタ

ArrayList クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
ArrayList ()	空で、既定の初期量を備えた、ArrayList クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
ArrayList (ICollection)	指定したコレクションからコピーした要素を格納し、コピーされる要素の数と同じ初期量を備えた、ArrayList クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
ArrayList (Int32)	空で、指定した初期量を備えた、ArrayList クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

ArrayList クラス
ArrayList メンバ
System.Collections 名前空間
Capacity

ArrayList プロパティ

パブリック プロパティ

	名前	説明
	SyncRoot	ArrayList へのアクセスを同期するために使用できるオブジェクトを取得します。

参照

関連項目

ArrayList クラス
System.Collections 名前空間
IList
System.Collections.Generic.List

その他の技術情報

カルチャを認識しないコレクションの操作の実行

ArrayList メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Adapter	特定の IList 用の ArrayList ラッパーを作成します。
	Add	ArrayList の末尾にオブジェクトを追加します。
	AddRange	ICollection の要素を ArrayList の末尾に追加します。
	BinarySearch	オーバーロードされます。 バイナリ サーチ アルゴリズムを使用して、並べ替えられた ArrayList 内の特定の要素またはその一部を検索します。
	Clear	ArrayList からすべての要素を削除します。
	Clone	ArrayList の簡易コピーを作成します。
	Contains	ある要素が ArrayList 内に存在するかどうかを判断します。
	CopyTo	オーバーロードされます。 ArrayList またはその一部を 1 次元配列にコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FixedSize	オーバーロードされます。 固定サイズのリスト ラッパーを返します。要素を変更することはできますが、追加や削除はできません。
	GetEnumerator	オーバーロードされます。 ArrayList を反復処理する列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetRange	元の ArrayList 内の要素のサブセットを表す ArrayList を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IndexOf	オーバーロードされます。 ArrayList 内またはその一部にある値のうち、最初に出現する値の、0 から始まるインデックス番号を返します。
	Insert	ArrayList 内の指定したインデックスの位置に要素を挿入します。
	InsertRange	コレクションの要素を ArrayList 内の指定したインデックスの位置に挿入します。
	LastIndexOf	オーバーロードされます。 ArrayList 内またはその一部にある値のうち、最後に出現する値の、0 から始まるインデックス番号を返します。
	ReadOnly	オーバーロードされます。 読み取り専用のリスト ラッパーを返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	ArrayList 内で最初に見つかった特定のオブジェクトを削除します。
	RemoveAt	ArrayList の指定したインデックスにある要素を削除します。
	RemoveRange	ArrayList から要素の範囲を削除します。
	Repeat	要素が指定した値のコピーである ArrayList を返します。
	Reverse	オーバーロードされます。 ArrayList 内およびその一部の要素の順序を反転させます。
	SetRange	コレクションの要素を ArrayList 内の要素の範囲にコピーします。
	Sort	オーバーロードされます。 ArrayList 内およびその一部の要素を並べ替えます。
	Synchronized	オーバーロードされます。 同期されている (スレッド セーフな) リスト ラッパーを返します。
	ToArray	オーバーロードされます。 ArrayList の要素を新しい配列にコピーします。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	TrimToSize	容量を ArrayList 内にある実際の要素数に設定します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

ArrayList クラス
System.Collections 名前空間
IList
System.Collections.Generic.List

その他の技術情報

カルチャを認識しないコレクションの操作の実行

ArrayList メンバ

必要に応じてサイズが動的に増加する配列を使用して、IList インターフェイスを実装します。

ArrayList データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	ArrayList	オーバーロードされます。 ArrayList クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	SyncRoot	ArrayList へのアクセスを同期するために使用できるオブジェクトを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Adapter	特定の IList 用の ArrayList ラッパーを作成します。
	Add	ArrayList の末尾にオブジェクトを追加します。
	AddRange	ICollection の要素を ArrayList の末尾に追加します。
	BinarySearch	オーバーロードされます。 バイナリ サーチ アルゴリズムを使用して、並べ替えられた ArrayList 内の特定の要素またはその一部を検索します。
	Clear	ArrayList からすべての要素を削除します。
	Clone	ArrayList の簡易コピーを作成します。
	Contains	ある要素が ArrayList 内に存在するかどうかを判断します。
	CopyTo	オーバーロードされます。 ArrayList またはその一部を 1 次元配列にコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FixedSize	オーバーロードされます。 固定サイズのリスト ラッパーを返します。要素を変更することはできますが、追加や削除はできません。
	GetEnumerator	オーバーロードされます。 ArrayList を反復処理する列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetRange	元の ArrayList 内の要素のサブセットを表す ArrayList を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IndexOf	オーバーロードされます。 ArrayList 内またはその一部にある値のうち、最初に出現する値の、0 から始まるインデックス番号を返します。
	Insert	ArrayList 内の指定したインデックスの位置に要素を挿入します。
	InsertRange	コレクションの要素を ArrayList 内の指定したインデックスの位置に挿入します。
	LastIndexOf	オーバーロードされます。 ArrayList 内またはその一部にある値のうち、最後に出現する値の、0 から始まるインデックス番号を返します。
	ReadOnly	オーバーロードされます。 読み取り専用のリスト ラッパーを返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	ArrayList 内で最初に見つかった特定のオブジェクトを削除します。
	RemoveAt	ArrayList の指定したインデックスにある要素を削除します。
	RemoveRange	ArrayList から要素の範囲を削除します。
	Repeat	要素が指定した値のコピーである ArrayList を返します。
	Reverse	オーバーロードされます。 ArrayList 内およびその一部の要素の順序を反転させます。
	SetRange	コレクションの要素を ArrayList 内の要素の範囲にコピーします。
	Sort	オーバーロードされます。 ArrayList 内およびその一部の要素を並べ替えます。
	Synchronized	オーバーロードされます。 同期されている (スレッド セーフな) リスト ラッパーを返します。
	ToArray	オーバーロードされます。 ArrayList の要素を新しい配列にコピーします。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	TrimToSize	容量を ArrayList 内にある実際の要素数に設定します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

ArrayList クラス
System.Collections 名前空間
IList
System.Collections.Generic.List

その他の技術情報

カルチャを認識しないコレクションの操作の実行