Tento článek byl přeložený strojově. Pokud chcete zobrazit článek v angličtině, zaškrtněte políčko Angličtina. Anglickou verzi článku můžete také zobrazit v místním okně přesunutím ukazatele myši nad text.
Překlad
Angličtina

Třída ArrayList

.NET Framework (current version)
 

Publikováno: srpen 2016

System_CAPS_notePoznámka

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Implementuje IList rozhraní pomocí pole, jejichž velikost se dynamicky mění podle potřeby.

K procházení zdrojového kódu rozhraní .NET Framework pro tento typ, naleznete v části Reference Source.

Obor názvů:   System.Collections
Sestavení:  mscorlib (v mscorlib.dll)


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

NázevPopis
System_CAPS_pubmethodArrayList()

Inicializuje novou instanci ArrayList třídu, která je prázdný a má výchozí počáteční kapacity.

System_CAPS_pubmethodArrayList(ICollection)

Inicializuje novou instanci ArrayList Třída obsahující elementů kopírovaných z určené kolekce, která má stejnou počáteční kapacitu jako počet prvků, které jsou zkopírovány.

System_CAPS_pubmethodArrayList(Int32)

Inicializuje novou instanci ArrayList třídu, která je prázdný a má zadaný počáteční kapacitu.

NázevPopis
System_CAPS_pubpropertyCapacity

Získá nebo nastaví počet prvků, která ArrayList může obsahovat.

System_CAPS_pubpropertyCount

Získá počet elementů obsažených ve skutečnosti ve ArrayList.

System_CAPS_pubpropertyIsFixedSize

Získává hodnotu označující zda ArrayList má pevnou velikost.

System_CAPS_pubpropertyIsReadOnly

Získává hodnotu označující zda ArrayList je jen pro čtení.

System_CAPS_pubpropertyIsSynchronized

Získá hodnotu označující zda přístup k ArrayList je synchronizován (zaručeno bezpečné používání vláken).

System_CAPS_pubpropertyItem[Int32]

Získá nebo nastaví prvek v zadaném indexu.

System_CAPS_pubpropertySyncRoot

Získá objekt, který lze použít k synchronizaci přístupu k ArrayList.

NázevPopis
System_CAPS_pubmethodSystem_CAPS_staticAdapter(IList)

Vytvoří ArrayList Obálka pro konkrétní IList.

System_CAPS_pubmethodAdd(Object)

Přidá na konec objektu ArrayList.

System_CAPS_pubmethodAddRange(ICollection)

Přidá prvky ICollection na konec ArrayList.

System_CAPS_pubmethodBinarySearch(Int32, Int32, Object, IComparer)

Vyhledá rozsahu prvků v seřazené ArrayList element pomocí zadaná porovnávací a vrátí z nuly vycházející index prvku.

System_CAPS_pubmethodBinarySearch(Object)

Vyhledá celý seřazeny ArrayList element pomocí výchozí porovnávací metody a vrátí z nuly vycházející index prvku.

System_CAPS_pubmethodBinarySearch(Object, IComparer)

Vyhledá celý řazeny ArrayList element pomocí zadaná porovnávací a vrátí z nuly vycházející index prvku.

System_CAPS_pubmethodClear()

Odebere všechny prvky z ArrayList.

System_CAPS_pubmethodClone()

Vytvoří Mělkou kopii ArrayList.

System_CAPS_pubmethodContains(Object)

Určuje, zda je prvek v ArrayList.

System_CAPS_pubmethodCopyTo(Array)

Zkopíruje celou ArrayList k jednorozměrné kompatibilní Array, začínající na začátku cílového pole.

System_CAPS_pubmethodCopyTo(Array, Int32)

Zkopíruje celou ArrayList k jednorozměrné kompatibilní Array, začínající zadaný index cílového pole.

System_CAPS_pubmethodCopyTo(Int32, Array, Int32, Int32)

Zkopíruje rozsahu prvků z ArrayList k jednorozměrné kompatibilní Array, začínající zadaný index cílového pole.

System_CAPS_pubmethodEquals(Object)

Určuje, zda se zadaný objekt rovná aktuálnímu objektu.(Zděděno z Object.)

System_CAPS_protmethodFinalize()

Umožňuje objekt k pokusu o uvolnění prostředků a provádět další operace čištění předtím, než je uvolněn systémem uvolňování paměti.(Zděděno z Object.)

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(ArrayList)

Vrátí ArrayList obálky s pevnou velikostí.

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(IList)

Vrátí IList obálky s pevnou velikostí.

System_CAPS_pubmethodGetEnumerator()

Vrátí enumerátor pro celý ArrayList.

System_CAPS_pubmethodGetEnumerator(Int32, Int32)

Vrátí enumerátor pro rozsah prvků v ArrayList.

System_CAPS_pubmethodGetHashCode()

Slouží jako výchozí funkce hash.(Zděděno z Object.)

System_CAPS_pubmethodGetRange(Int32, Int32)

Vrátí ArrayList která představuje podmnožinu prvky ve zdrojovém ArrayList.

System_CAPS_pubmethodGetType()

Získá Type aktuální instance.(Zděděno z Object.)

System_CAPS_pubmethodIndexOf(Object)

Vyhledá zadaný Object a vrátí z nuly vycházející index prvního výskytu v rámci celé ArrayList.

System_CAPS_pubmethodIndexOf(Object, Int32)

Vyhledá zadaný Object a vrátí z nuly vycházející index prvního výskytu v rámci rozsahu prvků v ArrayList rozšiřuje z určeného indexu na poslední prvek.

System_CAPS_pubmethodIndexOf(Object, Int32, Int32)

Vyhledá zadaný Object a vrátí z nuly vycházející index prvního výskytu v rámci rozsahu prvků v ArrayList který začíná na pozici zadaného indexu a obsahuje zadaný počet prvků.

System_CAPS_pubmethodInsert(Int32, Object)

Vloží prvek do ArrayList v zadaném indexu.

System_CAPS_pubmethodInsertRange(Int32, ICollection)

Vloží prvky kolekce do ArrayList v zadaném indexu.

System_CAPS_pubmethodLastIndexOf(Object)

Vyhledá zadaný Object a vrátí z nuly vycházející index posledního výskytu v rámci celé ArrayList.

System_CAPS_pubmethodLastIndexOf(Object, Int32)

Vyhledá zadaný Object a vrátí z nuly vycházející index posledního výskytu v rámci rozsahu prvků v ArrayList rozšiřuje od prvního prvku na zadaném indexu.

System_CAPS_pubmethodLastIndexOf(Object, Int32, Int32)

Vyhledá zadaný Object a vrátí z nuly vycházející index posledního výskytu v rámci rozsahu prvků v ArrayList obsahující zadaný počet prvků a končí v zadaném indexu.

System_CAPS_protmethodMemberwiseClone()

Vytvoří mělká kopie aktuálního Object.(Zděděno z Object.)

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(ArrayList)

Vrátí jen pro čtení ArrayList obálky.

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(IList)

Vrátí jen pro čtení IList obálky.

System_CAPS_pubmethodRemove(Object)

Odebere první výskyt určitého objektu z ArrayList.

System_CAPS_pubmethodRemoveAt(Int32)

Odebere prvek na zadaný index ArrayList.

System_CAPS_pubmethodRemoveRange(Int32, Int32)

Odebere rozsah prvků z ArrayList.

System_CAPS_pubmethodSystem_CAPS_staticRepeat(Object, Int32)

Vrátí ArrayList jejíž prvky jsou kopie se zadanou hodnotou.

System_CAPS_pubmethodReverse()

Obrátí pořadí prvků v celé ArrayList.

System_CAPS_pubmethodReverse(Int32, Int32)

Obrátí pořadí prvků v zadaném rozsahu.

System_CAPS_pubmethodSetRange(Int32, ICollection)

Zkopíruje prvky kolekce přes rozsahu prvků v ArrayList.

System_CAPS_pubmethodSort()

Seřadí prvky v celé ArrayList.

System_CAPS_pubmethodSort(IComparer)

Seřadí prvky v celé ArrayList pomocí zadaná porovnávací.

System_CAPS_pubmethodSort(Int32, Int32, IComparer)

Seřadí prvky v rozsahu prvků v ArrayList pomocí zadaná porovnávací.

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(ArrayList)

Vrátí ArrayList obálky, který je synchronizován (zaručeno bezpečné používání vláken).

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(IList)

Vrátí IList obálky, který je synchronizován (zaručeno bezpečné používání vláken).

System_CAPS_pubmethodToArray()

Zkopíruje prvky ArrayList na novou Object pole.

System_CAPS_pubmethodToArray(Type)

Zkopíruje prvky ArrayList do nového pole typu zadaného elementu.

System_CAPS_pubmethodToString()

Vrátí řetězec, který představuje aktuální objekt.(Zděděno z Object.)

System_CAPS_pubmethodTrimToSize()

Nastaví kapacity na skutečný počet prvků v ArrayList.

NázevPopis
System_CAPS_pubmethodAsParallel()

Přetížené Umožňuje paralelního zpracování dotazu.(Definoval ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Přetížené Převede IEnumerable do IQueryable.(Definoval Queryable.)

System_CAPS_pubmethodCast<TResult>()

Přetypování prvky IEnumerable do zadaného typu.(Definoval Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtry prvky IEnumerable na základě zadaného typu.(Definoval Enumerable.)

System_CAPS_notePoznámka

Chcete-li zobrazit zdrojový kód rozhraní .NET Framework pro tento typ, naleznete v části Reference Source. Můžete procházet zdrojový kód online, stahování odkazu pro zobrazení offline a krokovat zdroje (včetně oprav a aktualizací) během ladění. see instructions.

ArrayList Třídy je určen pro uložení heterogenní kolekce objektů. Nicméně vždy nenabízí nejlepší výkon. Místo toho doporučujeme následující postup:

  • Pro heterogenní kolekci objektů, použijte List<Object> (v jazyce C#) nebo List(Of Object) (v jazyce Visual Basic) zadejte.

  • Homogenní kolekci objektů, použijte List<T> třídy.

Naleznete v části "Důležité informace o výkonu" v List<T> referenčním tématu diskusi o relativní výkonu z těchto tříd.

ArrayList Není zaručeno, který se má seřadit. Je nutné seřadit ArrayList voláním jeho Sort Metoda před provedením operace (jako je například BinarySearch), které vyžadují ArrayList k řazení. Chcete-li zachovat kolekce, která je automaticky seřazen, jak jsou přidávány nové prvky, můžete použít SortedSet<T> třídy.

Kapacita ArrayList je počet prvků ArrayList může obsahovat. Jako prvky jsou přidány do ArrayList, bude automaticky vyšší kapacity podle potřeby prostřednictvím přerozdělení. Kapacitu lze snížit pomocí volání TrimToSize nebo nastavením Capacity vlastnost explicitně.

Pro velmi velké ArrayList objekty, můžete zvýšit maximální kapacity na 2 miliardy elementy v 64bitovém systému nastavením enabled atribut prvku konfigurace true v prostředí run-time.

Prvky v této kolekci lze přistupovat pomocí celé číslo indexu. Indexy v této kolekci jsou od nuly.

ArrayList Přijímá kolekce null jako platná hodnota. Umožňuje také duplicitní prvky.

Pomocí vícerozměrná pole jako prvky ArrayList kolekce není podporována.

Následující příklad kódu ukazuje, jak vytvořit a inicializovat ArrayList a jak zobrazit jeho hodnoty.

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   !

*/

Univerzální platforma Windows
K dispozici od 10
.NET Framework
K dispozici od 1.1

Veřejné statické (Shared v jazyce Visual Basic) členy tohoto typu jsou bezpečné podprocesy. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.

ArrayList Může podporovat více čtenáři současně, tak dlouho, dokud není upraven kolekce. K zajištění bezpečnosti vlákno ArrayList, všechny operace je třeba provést prostřednictvím obálky vrácený Synchronized Metoda.

Výčet prostřednictvím kolekce není bezpečným postupu. I když kolekce synchronizována, jiných vláken upravovat kolekce, což způsobí, že čítač vyvolá výjimku. Chcete-li zaručit zabezpečení vlákna během výčtu, můžete zamknout kolekci během celého výčtu nebo zachycovat výjimky vzniklé v důsledku změn prováděných ostatními vlákny.

Zpět na začátek
Zobrazit: