이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

ArrayList 클래스

 

게시 날짜: 2016년 11월

필요에 따라 크기가 동적으로 증가하는 배열을 사용하여 IList 인터페이스를 구현합니다.

이 형식에 대한 .NET Framework 소스 코드를 찾아보려면 참조 원본을 참조하세요.

네임스페이스:   System.Collections
어셈블리:  mscorlib(mscorlib.dll에 있음)


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

이름설명
System_CAPS_pubmethodArrayList()

비어 있는 상태에서 기본 초기 용량을 가지는 ArrayList 클래스의 새 인스턴스를 초기화합니다.

System_CAPS_pubmethodArrayList(ICollection)

지정한 컬렉션에서 복사된 요소가 포함되어 있고 복사된 요소의 수와 같은 초기 용량을 가지는 ArrayList 클래스의 새 인스턴스를 초기화합니다.

System_CAPS_pubmethodArrayList(Int32)

비어 있는 상태에서 지정한 초기 용량을 가지는 ArrayList 클래스의 새 인스턴스를 초기화합니다.

이름설명
System_CAPS_pubpropertyCapacity

ArrayList에 포함될 수 있는 요소의 수를 가져오거나 설정합니다.

System_CAPS_pubpropertyCount

ArrayList에 실제로 포함된 요소의 수를 가져옵니다.

System_CAPS_pubpropertyIsFixedSize

ArrayList의 크기가 고정되어 있는지를 나타내는 값을 가져옵니다.

System_CAPS_pubpropertyIsReadOnly

ArrayList가 읽기 전용인지 여부를 나타내는 값을 가져옵니다.

System_CAPS_pubpropertyIsSynchronized

ArrayList에 대한 액세스가 동기화되어 스레드로부터 안전하게 보호되는지를 나타내는 값을 가져옵니다.

System_CAPS_pubpropertyItem[Int32]

지정한 인덱스에 있는 요소를 가져오거나 설정합니다.

System_CAPS_pubpropertySyncRoot

ArrayList에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.

이름설명
System_CAPS_pubmethodSystem_CAPS_staticAdapter(IList)

특정 IList에 대해 ArrayList 래퍼를 만듭니다.

System_CAPS_pubmethodAdd(Object)

개체를 ArrayList의 끝 부분에 추가합니다.

System_CAPS_pubmethodAddRange(ICollection)

ICollection의 요소를 ArrayList의 끝에 추가합니다.

System_CAPS_pubmethodBinarySearch(Int32, Int32, Object, IComparer)

지정된 비교자를 사용하여 정렬된 ArrayList의 요소 범위에서 요소를 검색하고 요소의 인덱스(0부터 시작)를 반환합니다.

System_CAPS_pubmethodBinarySearch(Object)

기본 비교자를 사용하여 정렬된 전체 ArrayList에서 요소를 검색하고 요소의 인덱스(0부터 시작)를 반환합니다.

System_CAPS_pubmethodBinarySearch(Object, IComparer)

지정된 비교자를 사용하여 정렬된 전체 ArrayList에서 요소를 검색하고 요소의 인덱스(0부터 시작)를 반환합니다.

System_CAPS_pubmethodClear()

ArrayList에서 요소를 모두 제거합니다.

System_CAPS_pubmethodClone()

ArrayList의 부분 복사본을 만듭니다.

System_CAPS_pubmethodContains(Object)

ArrayList에 요소가 있는지 여부를 확인합니다.

System_CAPS_pubmethodCopyTo(Array)

대상 배열의 맨 처음부터 시작하여 전체 ArrayList를 호환되는 1차원 Array에 복사합니다.

System_CAPS_pubmethodCopyTo(Array, Int32)

대상 배열의 지정된 인덱스에서 시작하여 전체 ArrayList을 호환되는 1차원 Array에 복사합니다.

System_CAPS_pubmethodCopyTo(Int32, Array, Int32, Int32)

대상 배열의 지정한 인덱스에서 시작하여 ArrayList의 요소 범위를 호환되는 1차원 Array에 복사합니다.

System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)

System_CAPS_protmethodFinalize()

개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(ArrayList)

고정 크기의 ArrayList 래퍼를 반환합니다.

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(IList)

고정 크기의 IList 래퍼를 반환합니다.

System_CAPS_pubmethodGetEnumerator()

전체 ArrayList에 대한 열거자를 반환합니다.

System_CAPS_pubmethodGetEnumerator(Int32, Int32)

ArrayList의 요소 범위에 대한 열거자를 반환합니다.

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다.(Object에서 상속됨)

System_CAPS_pubmethodGetRange(Int32, Int32)

소스 ArrayList에서 요소의 하위 집합을 나타내는 ArrayList를 반환합니다.

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_pubmethodIndexOf(Object)

지정한 Object를 검색하고, 전체 ArrayList 내에서 처음 나오는 0부터 시작하는 인덱스를 반환합니다.

System_CAPS_pubmethodIndexOf(Object, Int32)

지정된 Object를 검색하고, 지정된 인덱스부터 마지막 요소까지 포함되는 ArrayList의 요소 범위에서 처음 나오는 0부터 시작하는 인덱스를 반환합니다.

System_CAPS_pubmethodIndexOf(Object, Int32, Int32)

지정된 Object를 검색하고, 지정된 인덱스부터 시작하여 지정된 수의 요소를 포함하는 ArrayList의 요소 범위에서 처음 나오는 0부터 시작하는 인덱스를 반환합니다.

System_CAPS_pubmethodInsert(Int32, Object)

ArrayList의 지정된 인덱스에 요소를 삽입합니다.

System_CAPS_pubmethodInsertRange(Int32, ICollection)

ArrayList의 지정된 인덱스에 컬렉션의 요소를 삽입합니다.

System_CAPS_pubmethodLastIndexOf(Object)

지정한 Object 검색하고, 전체 ArrayList 내에서 마지막으로 검색된 항목의 0부터 시작하는 인덱스를 반환합니다.

System_CAPS_pubmethodLastIndexOf(Object, Int32)

지정된 Object를 검색하고, 첫 번째 요소부터 지정된 인덱스까지 확장되는 ArrayList의 요소 범위에서 마지막으로 검색된 항목의 0부터 시작하는 인덱스를 반환합니다.

System_CAPS_pubmethodLastIndexOf(Object, Int32, Int32)

지정된 Object를 검색하며, 지정된 수의 요소를 포함하고 지정된 인덱스에서 끝나는 ArrayList의 요소 범위에서 마지막으로 검색되는 0부터 시작하는 인덱스를 반환합니다.

System_CAPS_protmethodMemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.(Object에서 상속됨)

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(ArrayList)

읽기 전용 ArrayList 래퍼를 반환합니다.

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(IList)

읽기 전용 IList 래퍼를 반환합니다.

System_CAPS_pubmethodRemove(Object)

ArrayList에서 맨 처음 발견되는 특정 개체를 제거합니다.

System_CAPS_pubmethodRemoveAt(Int32)

ArrayList의 지정한 인덱스에서 요소를 제거합니다.

System_CAPS_pubmethodRemoveRange(Int32, Int32)

ArrayList에서 요소의 범위를 제거합니다.

System_CAPS_pubmethodSystem_CAPS_staticRepeat(Object, Int32)

요소가 지정된 값의 복사본인 ArrayList를 반환합니다.

System_CAPS_pubmethodReverse()

전체 ArrayList에서 요소의 순서를 반대로 바꿉니다.

System_CAPS_pubmethodReverse(Int32, Int32)

지정된 범위에서 요소의 순서를 반대로 바꿉니다.

System_CAPS_pubmethodSetRange(Int32, ICollection)

ArrayList의 요소 범위에 대해 컬렉션의 요소를 복사합니다.

System_CAPS_pubmethodSort()

전체 ArrayList의 요소를 정렬합니다.

System_CAPS_pubmethodSort(IComparer)

지정된 비교자를 사용하여 전체 ArrayList에 있는 요소를 정렬합니다.

System_CAPS_pubmethodSort(Int32, Int32, IComparer)

지정된 비교자를 사용하여 ArrayList의 요소 범위에 있는 요소를 정렬합니다.

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(ArrayList)

동기화되어 스레드로부터 안전하게 보호되는 ArrayList 래퍼를 반환합니다.

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(IList)

동기화되어 스레드로부터 안전하게 보호되는 IList 래퍼를 반환합니다.

System_CAPS_pubmethodToArray()

ArrayList의 요소를 새 Object 배열에 복사합니다.

System_CAPS_pubmethodToArray(Type)

ArrayList의 요소를 지정된 요소 형식의 새 배열에 복사합니다.

System_CAPS_pubmethodToString()

현재 개체를 나타내는 문자열을 반환합니다.(Object에서 상속됨)

System_CAPS_pubmethodTrimToSize()

용량을 ArrayList의 실제 요소 수로 설정합니다.

이름설명
System_CAPS_pubmethodAsParallel()

오버로드되었습니다. 쿼리를 병렬화할 수 있도록 합니다.(ParallelEnumerable에서 정의됨)

System_CAPS_pubmethodAsQueryable()

오버로드되었습니다. 변환 된 IEnumerableIQueryable합니다.(Queryable에서 정의됨)

System_CAPS_pubmethodCast<TResult>()

요소에 캐스트는 IEnumerable 지정 된 형식입니다.(Enumerable에서 정의됨)

System_CAPS_pubmethodOfType<TResult>()

요소를 필터링 한 IEnumerable 지정된 된 형식에 기반 합니다.(Enumerable에서 정의됨)

System_CAPS_note참고

To view the .NET Framework source code for this type, see the Reference Sourcehttp://referencesource.microsoft.com/#mscorlib/system/collections/arraylist.cs#3e3f6715773d6643. You can browse through the source code online, download the reference for offline viewing, and step through the sources (including patches and updates) during debugging; see instructionshttp://referencesource.microsoft.com/.

The T:System.Collections.ArrayList class is designed to hold heterogeneous collections of objects. However, it does not always offer the best performance. Instead, we recommend the following:

  • For a heterogeneous collection of objects, use the List<Object> (in C#) or List(Of Object) (in Visual Basic) type.

  • For a homogeneous collection of objects, use the T:System.Collections.Generic.List`1 class.

See the "Performance Considerations" section in the T:System.Collections.Generic.List`1 reference topic for a discussion of the relative performance of these classes.

The T:System.Collections.ArrayList is not guaranteed to be sorted. You must sort the T:System.Collections.ArrayList by calling its M:System.Collections.ArrayList.Sort method prior to performing operations (such as Overload:System.Collections.ArrayList.BinarySearch) that require the T:System.Collections.ArrayList to be sorted. To maintain a collection that is automatically sorted as new elements are added, you can use the T:System.Collections.Generic.SortedSet`1 class.

The capacity of an T:System.Collections.ArrayList is the number of elements the T:System.Collections.ArrayList can hold. As elements are added to an T:System.Collections.ArrayList, the capacity is automatically increased as required through reallocation. The capacity can be decreased by calling M:System.Collections.ArrayList.TrimToSize or by setting the P:System.Collections.ArrayList.Capacity property explicitly.

For very large T:System.Collections.ArrayList objects, you can increase the maximum capacity to 2 billion elements on a 64-bit system by setting the enabled attribute of the configuration element to true in the run-time environment.

Elements in this collection can be accessed using an integer index. Indexes in this collection are zero-based.

The T:System.Collections.ArrayList collection accepts null as a valid value. It also allows duplicate elements.

Using multidimensional arrays as elements in an T:System.Collections.ArrayList collection is not supported.

The following code example shows how to create and initialize an T:System.Collections.ArrayList and how to display its values.

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   !

*/

유니버설 Windows 플랫폼
10 이후 사용 가능
.NET Framework
1.1 이후 사용 가능

Public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

An T:System.Collections.ArrayList can support multiple readers concurrently, as long as the collection is not modified. To guarantee the thread safety of the T:System.Collections.ArrayList, all operations must be done through the wrapper returned by the M:System.Collections.ArrayList.Synchronized(System.Collections.IList) method.

Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

맨 위로 이동
표시: