
This is the Title of the Book, eMatter Edition
Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.
Creating a Read-Only Array or List<T>
|
321
// Create a read-only strings List.
IList<string> readOnlyStrings = strings.AsReadOnly( );
// Display them.
foreach (string s in readOnlyStrings)
Console.WriteLine(s);
Discussion
The AsReadOnly method accepts no parameters and returns a read-only wrapper
around the collection on which it is called. For example, the following statement:
IList<string> readOnlyStrings = strings.AsReadOnly( );
returns a read-only IList<string> type from the original strings List<string> type.
This read-only
readOnlyStrings variable behaves similarly to the original strings
object, except that you cannot add, modify, or delete elements from this object. If
you attempt one of these actions, a
System.NotSupportedException will be thrown
along with the message “Collection is read-only”. Any of the following lines of code
will cause this exception to be thrown:
readOnlyStrings.Add("5");
readOnlyStrings.Remove("1");
readOnlyStrings[0] = "1.1";
While you cannot modify the data within the readOnlyStrings object, you can point
this object to refer to a different object of type
IList<string>, for example:
readOnlyStrings = new List<string>( );
On the other hand, if you add, modify, or delete elements from the original strings
object, the changes will be reflected in the new readOnlyStrings ...