Partager via


Array.AsReadOnly<T> Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns a read-only wrapper for the specified array.

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

Syntax

'Declaration
Public Shared Function AsReadOnly(Of T) ( _
    array As T() _
) As ReadOnlyCollection(Of T)
public static ReadOnlyCollection<T> AsReadOnly<T>(
    T[] array
)

Type Parameters

  • T
    The type of the elements of the array.

Parameters

  • array
    Type: array<T[]
    The one-dimensional, zero-based array to wrap in a read-only ReadOnlyCollection<T> wrapper.

Return Value

Type: System.Collections.ObjectModel.ReadOnlyCollection<T>
A read-only ReadOnlyCollection<T> wrapper for the specified array.

Exceptions

Exception Condition
ArgumentNullException

array is nulla null reference (Nothing in Visual Basic).

Remarks

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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

See Also

Reference