AsReadOnly(T) Method

Array.AsReadOnly(Of T) Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Returns a read-only wrapper for the specified array.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
Public Shared Function AsReadOnly(Of T) ( _
	array As T() _
) As ReadOnlyCollection(Of T)

Type Parameters

T

The type of the elements of the array.

Parameters

array
Type: T ()
The one-dimensional, zero-based array to wrap in a read-only ReadOnlyCollection(Of T) wrapper.

Return Value

Type: System.Collections.ObjectModel.ReadOnlyCollection(Of T)
A read-only ReadOnlyCollection(Of T) wrapper for the specified array.

ExceptionCondition
ArgumentNullException

array is Nothing.

To prevent any modifications to the array, expose the array only through this wrapper.

A collection that is read-only is simply a collection with a wrapper that prevents modifying the collection; therefore, if changes are made to the underlying collection, the read-only collection reflects those changes.

This method is an O(1) operation.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2016 Microsoft