ArrayList クラス

定義

public ref class ArrayList : System::Collections::IList

public ref class ArrayList : ICloneable, System::Collections::IList

public class ArrayList : System.Collections.IList

public class ArrayList : ICloneable, System.Collections.IList

[System.Serializable]
public class ArrayList : ICloneable, System.Collections.IList

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArrayList : ICloneable, System.Collections.IList

type ArrayList = class
    interface IEnumerable
    interface IList
    interface ICollection

type ArrayList = class
    interface ICollection
    interface IEnumerable
    interface IList
    interface ICloneable

type ArrayList = class
    interface IEnumerable
    interface IList
    interface ICollection
    interface ICloneable

[<System.Serializable>]
type ArrayList = class
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArrayList = class
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class ArrayList
Implements IList

Public Class ArrayList
Implements ICloneable, IList

継承

Object

ArrayList

派生

System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection

属性

SerializableAttribute ComVisibleAttribute

実装

ICollection IEnumerable IList ICloneable

例

次の例は、 ArrayList を作成して初期化する方法と、その値を表示する方法を示しています。

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: 4
    Values:   Hello   World   !

*/

Imports System.Collections

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

End Class


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

注釈

ArrayList が並べ替えられる保証はありません。 ArrayListを並べ替える必要がある操作 (BinarySearch など) を実行する前に、Sort メソッドを呼び出してArrayListを並べ替える必要があります。 新しい要素が追加されるときに自動的に並べ替えられるコレクションを維持するには、 SortedSet<T> クラスを使用できます。

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

.NET Framework のみ:非常に大きなArrayList オブジェクトの場合は、<gcAllowVeryLargeObjects>構成要素のenabled属性を実行時環境でtrueに設定することで、64 ビット システムで最大容量を 20 億要素に増やすことができます。

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

ArrayList コレクションは、有効な値としてnullを受け入れます。 また、重複する要素も許可されます。

ArrayList コレクション内の要素として多次元配列を使用することはサポートされていません。

スレッド セーフ

この型のパブリック静的 (Visual Basic のShared ) メンバーはスレッド セーフです。 インスタンス メンバーがスレッド セーフであるとは限りません。

コレクションが変更されない限り、 ArrayList は複数のリーダーを同時にサポートできます。 ArrayListのスレッド セーフを保証するには、Synchronized(IList) メソッドによって返されるラッパーを通じてすべての操作を実行する必要があります。

コレクションを列挙することは、本質的にスレッド セーフなプロシージャではありません。 コレクションが同期されている場合でも、他のスレッドはコレクションを変更できるため、列挙子は例外をスローします。 列挙中のスレッド セーフを保証するには、列挙全体の間にコレクションをロックするか、他のスレッドによって行われた変更によって発生する例外をキャッチします。

こちらもご覧ください

• IList
• List<T>
• コレクションでの Culture-Insensitive 文字列操作の実行