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.