ArrayList.Add(Object) Metoda

Definice

Obor názvů:

System.Collections

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

ArrayList.cs

Přidá objekt na konec objektu ArrayList.

public:
 virtual int Add(System::Object ^ value);

public virtual int Add(object? value);

abstract member Add : obj -> int
override this.Add : obj -> int

Public Overridable Function Add (value As Object) As Integer

Parametry

value

Object

Hodnota Object , která má být přidána na konec ArrayList. Hodnota může být null.

Návraty

Int32

Index ArrayList , ke kterému value byl přidán.

Implementuje

Add(Object)

Výjimky

NotSupportedException

Je ArrayList jen pro čtení.

nebo

Má ArrayList pevnou velikost.

Příklady

Následující příklad kódu ukazuje, jak přidat elementy ArrayListdo .

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

   public static void Main()  {

      // Creates and initializes a new ArrayList.
      ArrayList myAL = new ArrayList();
      myAL.Add( "The" );
      myAL.Add( "quick" );
      myAL.Add( "brown" );
      myAL.Add( "fox" );

      // Creates and initializes a new Queue.
      Queue myQueue = new Queue();
      myQueue.Enqueue( "jumps" );
      myQueue.Enqueue( "over" );
      myQueue.Enqueue( "the" );
      myQueue.Enqueue( "lazy" );
      myQueue.Enqueue( "dog" );

      // Displays the ArrayList and the Queue.
      Console.WriteLine( "The ArrayList initially contains the following:" );
      PrintValues( myAL, '\t' );
      Console.WriteLine( "The Queue initially contains the following:" );
      PrintValues( myQueue, '\t' );

      // Copies the Queue elements to the end of the ArrayList.
      myAL.AddRange( myQueue );

      // Displays the ArrayList.
      Console.WriteLine( "The ArrayList now contains the following:" );
      PrintValues( myAL, '\t' );
   }

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


/*
This code produces the following output.

The ArrayList initially contains the following:
    The    quick    brown    fox
The Queue initially contains the following:
    jumps    over    the    lazy    dog
The ArrayList now contains the following:
    The    quick    brown    fox    jumps    over    the    lazy    dog
*/

Imports System.Collections

Public Class SamplesArrayList    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new ArrayList.
        Dim myAL As New ArrayList()
        myAL.Add("The")
        myAL.Add("quick")
        myAL.Add("brown")
        myAL.Add("fox")
        
        ' Creates and initializes a new Queue.
        Dim myQueue As New Queue()
        myQueue.Enqueue("jumps")
        myQueue.Enqueue("over")
        myQueue.Enqueue("the")
        myQueue.Enqueue("lazy")
        myQueue.Enqueue("dog")
        
        ' Displays the ArrayList and the Queue.
        Console.WriteLine("The ArrayList initially contains the following:")
        PrintValues(myAL, ControlChars.Tab)
        Console.WriteLine("The Queue initially contains the following:")
        PrintValues(myQueue, ControlChars.Tab)
        
        ' Copies the Queue elements to the end of the ArrayList.
        myAL.AddRange(myQueue)
        
        ' Displays the ArrayList.
        Console.WriteLine("The ArrayList now contains the following:")
        PrintValues(myAL, ControlChars.Tab)
    End Sub

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

End Class


' This code produces the following output.
' 
' The ArrayList initially contains the following:
'     The    quick    brown    fox
' The Queue initially contains the following:
'     jumps    over    the    lazy    dog
' The ArrayList now contains the following:
'     The    quick    brown    fox    jumps    over    the    lazy    dog

Poznámky

ArrayList přijímá null jako platnou hodnotu a umožňuje duplicitní prvky.

Pokud Count se již rovná Capacity, kapacita ArrayList je zvýšena automatickým přidělením interního pole a existující prvky se zkopírují do nového pole před přidáním nového prvku.

Pokud Count je menší než Capacity, tato metoda je O(1) operace. Pokud je potřeba zvýšit kapacitu tak, aby vyhovovala novému prvku, stane se O(n) tato metoda operací, kde n je Count.

Viz také

• AddRange(ICollection)
• Insert(Int32, Object)
• Remove(Object)
• Count