StringCollection Class

StringCollection Class

 

Represents a collection of strings.

Namespace:   System.Collections.Specialized
Assembly:  System (in System.dll)

System.Object
  System.Collections.Specialized.StringCollection
    System.Configuration.CommaDelimitedStringCollection

[<SerializableAttribute>]
type StringCollection = 
    class
        interface IList
        interface ICollection
        interface IEnumerable
    end

NameDescription
System_CAPS_pubmethodStringCollection()

Initializes a new instance of the StringCollection class.

NameDescription
System_CAPS_pubpropertyCount

Gets the number of strings contained in the StringCollection.

System_CAPS_pubpropertyIsReadOnly

Gets a value indicating whether the StringCollection is read-only.

System_CAPS_pubpropertyIsSynchronized

Gets a value indicating whether access to the StringCollection is synchronized (thread safe).

System_CAPS_pubpropertyItem(Int32)

Gets or sets the element at the specified index.

System_CAPS_pubpropertySyncRoot

Gets an object that can be used to synchronize access to the StringCollection.

NameDescription
System_CAPS_pubmethodAdd(String)

Adds a string to the end of the StringCollection.

System_CAPS_pubmethodAddRange(String[])

Copies the elements of a string array to the end of the StringCollection.

System_CAPS_pubmethodClear()

Removes all the strings from the StringCollection.

System_CAPS_pubmethodContains(String)

Determines whether the specified string is in the StringCollection.

System_CAPS_pubmethodCopyTo(String[], Int32)

Copies the entire StringCollection values to a one-dimensional array of strings, starting at the specified index of the target array.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetEnumerator()

Returns a StringEnumerator that iterates through the StringCollection.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodIndexOf(String)

Searches for the specified string and returns the zero-based index of the first occurrence within the StringCollection.

System_CAPS_pubmethodInsert(Int32, String)

Inserts a string into the StringCollection at the specified index.

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodRemove(String)

Removes the first occurrence of a specific string from the StringCollection.

System_CAPS_pubmethodRemoveAt(Int32)

Removes the string at the specified index of the StringCollection.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Copies the entire StringCollection to a compatible one-dimensional Array, starting at the specified index of the target array.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable.GetEnumerator()

Returns a IEnumerator that iterates through the StringCollection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Adds an object to the end of the StringCollection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Determines whether an element is in the StringCollection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Searches for the specified Object and returns the zero-based index of the first occurrence within the entire StringCollection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Inserts an element into the StringCollection at the specified index.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Removes the first occurrence of a specific object from the StringCollection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Gets a value indicating whether the StringCollection object has a fixed size.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsReadOnly

Gets a value indicating whether the StringCollection object is read-only.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item(Int32)

Gets or sets the element at the specified index.

NameDescription
System_CAPS_pubmethodAsParallel()

Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)

System_CAPS_pubmethodCast<'TResult>()

Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)

System_CAPS_pubmethodOfType<'TResult>()

Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

StringCollection accepts null as a valid value and allows duplicate elements.

String comparisons are case-sensitive.

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

The following code example demonstrates several of the properties and methods of StringCollection.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 10
.NET Framework
Available since 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.

This implementation does not provide a synchronized (thread safe) wrapper for a StringCollection, but derived classes can create their own synchronized versions of the StringCollection using the SyncRoot property.

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.

Return to top
Show:
© 2016 Microsoft