London Dev Meetup Rescheduled! Due to unavoidable reasons, the event has been moved to 21st May. Speakers remain the same—any changes will be communicated. Seats are limited—register here to secure your spot!

Class ReadOnlyStringList

A read-only collection of string with case insensitive comparisons. The items are stored as upper invariant case.

Inheritance
System.Object
ReadOnlyStringList
Implements
System.Collections.Generic.IList<System.String>
System.Collections.Generic.ICollection<System.String>
System.Collections.Generic.IEnumerable<System.String>
System.Collections.IEnumerable
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: EPiServer.Core
Assembly: EPiServer.dll
Version: 10.10.4
Syntax
public class ReadOnlyStringList : IList<string>, ICollection<string>, IEnumerable<string>, IEnumerable

Constructors

ReadOnlyStringList(IList<String>)

Initializes a new instance of the ReadOnlyStringList class.

Declaration
public ReadOnlyStringList(IList<string> items)
Parameters
Type Name Description
System.Collections.Generic.IList<System.String> items

The items.

Properties

Count

Gets the number of elements contained in the System.Collections.Generic.ICollection<T>.

Declaration
public int Count { get; }
Property Value
Type Description
System.Int32

IsReadOnly

Gets a value indicating whether the System.Collections.Generic.ICollection<T> is read-only.

Declaration
public bool IsReadOnly { get; }
Property Value
Type Description
System.Boolean

Item[Int32]

Gets or the System.String at the specified index. Set is not a valid operation on a readonly list. Will throw InvalidOperationException;

Declaration
public string this[int index] { get; set; }
Parameters
Type Name Description
System.Int32 index
Property Value
Type Description
System.String

Methods

Add(String)

Not a valid operation on a readonly list. Will throw InvalidOperationException;

Declaration
public void Add(string item)
Parameters
Type Name Description
System.String item

The object to add to the System.Collections.Generic.ICollection<T>.

Exceptions
Type Condition
System.NotSupportedException

The System.Collections.Generic.ICollection<T> is read-only.

Clear()

Not a valid operation on a readonly list. Will throw InvalidOperationException;

Declaration
public void Clear()
Exceptions
Type Condition
System.NotSupportedException

The System.Collections.Generic.ICollection<T> is read-only.

Contains(String)

Determines whether the System.Collections.Generic.ICollection<T> contains a specific value. The compairson will be performed on upper invariant case.

Declaration
public bool Contains(string item)
Parameters
Type Name Description
System.String item

The object to locate in the System.Collections.Generic.ICollection<T>.

Returns
Type Description
System.Boolean

true if item is found in the System.Collections.Generic.ICollection<T>; otherwise, false.

CopyTo(String[], Int32)

Copies the elements of the System.Collections.Generic.ICollection<T> to an System.Array, starting at a particular System.Array index.

Declaration
public void CopyTo(string[] array, int arrayIndex)
Parameters
Type Name Description
System.String[] array

The one-dimensional System.Array that is the destination of the elements copied from System.Collections.Generic.ICollection<T>. The System.Array must have zero-based indexing.

System.Int32 arrayIndex

The zero-based index in array at which copying begins.

Exceptions
Type Condition
System.ArgumentNullException

array is null.

System.ArgumentOutOfRangeException

arrayIndex is less than 0.

System.ArgumentException

array is multidimensional.-or-arrayIndex is equal to or greater than the length of array.-or-The number of elements in the source System.Collections.Generic.ICollection<T> is greater than the available space from arrayIndex to the end of the destination array.-or-Type cannot be cast automatically to the type of the destination array.

GetEnumerator()

Returns an enumerator that iterates through the collection.

Declaration
public IEnumerator<string> GetEnumerator()
Returns
Type Description
System.Collections.Generic.IEnumerator<System.String>

A System.Collections.Generic.IEnumerator<T> that can be used to iterate through the collection.

IndexOf(String)

Determines the index of a specific item in the System.Collections.Generic.IList<T>.

Declaration
public int IndexOf(string item)
Parameters
Type Name Description
System.String item

The object to locate in the System.Collections.Generic.IList<T>.

Returns
Type Description
System.Int32

The index of item if found in the list; otherwise, -1.

Insert(Int32, String)

Not a valid operation on a readonly list. Will throw InvalidOperationException;

Declaration
public void Insert(int index, string item)
Parameters
Type Name Description
System.Int32 index

The zero-based index at which item should be inserted.

System.String item

The object to insert into the System.Collections.Generic.IList<T>.

Exceptions
Type Condition
System.ArgumentOutOfRangeException

index is not a valid index in the System.Collections.Generic.IList<T>.

System.NotSupportedException

The System.Collections.Generic.IList<T> is read-only.

Remove(String)

Not a valid operation on a readonly list. Will throw InvalidOperationException;

Declaration
public bool Remove(string item)
Parameters
Type Name Description
System.String item

The object to remove from the System.Collections.Generic.ICollection<T>.

Returns
Type Description
System.Boolean

true if item was successfully removed from the System.Collections.Generic.ICollection<T>; otherwise, false. This method also returns false if item is not found in the original System.Collections.Generic.ICollection<T>.

Exceptions
Type Condition
System.NotSupportedException

The System.Collections.Generic.ICollection<T> is read-only.

RemoveAt(Int32)

Not a valid operation on a readonly list. Will throw InvalidOperationException;

Declaration
public void RemoveAt(int index)
Parameters
Type Name Description
System.Int32 index

The zero-based index of the item to remove.

Exceptions
Type Condition
System.ArgumentOutOfRangeException

index is not a valid index in the System.Collections.Generic.IList<T>.

System.NotSupportedException

The System.Collections.Generic.IList<T> is read-only.

Explicit Interface Implementations

IEnumerable.GetEnumerator()

Returns an enumerator that iterates through a collection.

Declaration
IEnumerator IEnumerable.GetEnumerator()
Returns
Type Description
System.Collections.IEnumerator

An System.Collections.IEnumerator object that can be used to iterate through the collection.

Implements

System.Collections.Generic.IList<T>
System.Collections.Generic.ICollection<T>
System.Collections.Generic.IEnumerable<T>
System.Collections.IEnumerable

Extension Methods