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 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   !

*/

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 , вызвав его Sort метод перед выполнением операций (например BinarySearch, ), для которых требуется ArrayList отсортировать . Чтобы сохранить коллекцию, которая автоматически сортируется по мере добавления новых элементов, можно использовать SortedSet<T> класс .

Емкость ArrayList — это количество элементов, которые могут храниться ArrayList . При добавлении элементов в ArrayListемкость автоматически увеличивается по мере необходимости путем перераспределения. Емкость можно уменьшить путем вызова TrimToSize или явного Capacity задания свойства.

Только платформа .NET Framework. Для очень больших ArrayList объектов можно увеличить максимальную емкость до 2 миллиардов элементов в 64-разрядной системе, задав enabled атрибуту <gcAllowVeryLargeObjects> элемента конфигурации значение true в среде выполнения.

Доступ к элементам в этой коллекции можно получить с помощью целочисленного индекса. Индексы в этой коллекции отсчитываются от нуля.

Коллекция ArrayList принимает в null качестве допустимого значения. Он также позволяет дублировать элементы.

Использование многомерных массивов в качестве элементов в ArrayList коллекции не поддерживается.

Конструкторы

Свойства

Методы

Методы расширения

Применяется к

Потокобезопасность

Открытые статические (Shared в Visual Basic) члены этого типа являются потокобезопасными. Потокобезопасная работа с членами экземпляров типа не гарантируется.

может ArrayList поддерживать несколько модулей чтения одновременно, если коллекция не изменяется. Чтобы гарантировать потокобезопасность ArrayList, все операции должны выполняться через оболочку, возвращаемую методом Synchronized(IList) .

Перечисление коллекции не является потокобезопасной процедурой. Даже если коллекция синхронизирована, другие потоки могут ее изменить, что приведет к тому, что перечислитель создаст исключение. Для обеспечения потокобезопасности при перечислении можно либо заблокировать коллекцию на все время перечисления, либо перехватывать исключения, возникающие в результате изменений, внесенных другими потоками.

См. также раздел

• IList
• List<T>
• Выполнение строковых операций без учета языка и региональных параметров в коллекциях