The Labs \ Source Viewer \ SSCLI \ System.Collections \ CollectionBase

  1. // ==++==
  2. //
  3. //
  4. // Copyright (c) 2006 Microsoft Corporation. All rights reserved.
  5. //
  6. // The use and distribution terms for this software are contained in the file
  7. // named license.txt, which can be found in the root of this distribution.
  8. // By using this software in any fashion, you are agreeing to be bound by the
  9. // terms of this license.
  10. //
  11. // You must not remove this notice, or any other, from this software.
  12. //
  13. //
  14. // ==--==
  15. //------------------------------------------------------------------------------
  16. //------------------------------------------------------------------------------
  17. namespace System.Collections
  18. {
  19.     using System;
  20.    
  21.     // Useful base class for typed read/write collections where items derive from object
  22.     [Serializable()]
  23.     [System.Runtime.InteropServices.ComVisible(true)]
  24.     public abstract class CollectionBase : IList
  25.     {
  26.         ArrayList list;
  27.        
  28.         protected CollectionBase()
  29.         {
  30.             list = new ArrayList();
  31.         }
  32.        
  33.         protected CollectionBase(int capacity)
  34.         {
  35.             list = new ArrayList(capacity);
  36.         }
  37.        
  38.        
  39.         protected ArrayList InnerList {
  40.             get {
  41.                 if (list == null)
  42.                     list = new ArrayList();
  43.                 return list;
  44.             }
  45.         }
  46.        
  47.         protected IList List {
  48.             get { return (IList)this; }
  49.         }
  50.        
  51.         [System.Runtime.InteropServices.ComVisible(false)]
  52.         public int Capacity {
  53.             get { return InnerList.Capacity; }
  54.             set { InnerList.Capacity = value; }
  55.         }
  56.        
  57.        
  58.         public int Count {
  59.             get { return list == null ? 0 : list.Count; }
  60.         }
  61.        
  62.         public void Clear()
  63.         {
  64.             OnClear();
  65.             InnerList.Clear();
  66.             OnClearComplete();
  67.         }
  68.        
  69.         public void RemoveAt(int index)
  70.         {
  71.             if (index < 0 || index >= InnerList.Count)
  72.                 throw new ArgumentOutOfRangeException("index", Environment.GetResourceString("ArgumentOutOfRange_Index"));
  73.             object temp = InnerList[index];
  74.             OnValidate(temp);
  75.             OnRemove(index, temp);
  76.             InnerList.RemoveAt(index);
  77.             try {
  78.                 OnRemoveComplete(index, temp);
  79.             }
  80.             catch {
  81.                 InnerList.Insert(index, temp);
  82.                 throw;
  83.             }
  84.            
  85.         }
  86.        
  87.         bool IList.IsReadOnly {
  88.             get { return InnerList.IsReadOnly; }
  89.         }
  90.        
  91.         bool IList.IsFixedSize {
  92.             get { return InnerList.IsFixedSize; }
  93.         }
  94.        
  95.         bool ICollection.IsSynchronized {
  96.             get { return InnerList.IsSynchronized; }
  97.         }
  98.        
  99.         object ICollection.SyncRoot {
  100.             get { return InnerList.SyncRoot; }
  101.         }
  102.        
  103.         void ICollection.CopyTo(Array array, int index)
  104.         {
  105.             InnerList.CopyTo(array, index);
  106.         }
  107.        
  108.         object IList.this[int index]
  109.         {
  110.             get {
  111.                 if (index < 0 || index >= InnerList.Count)
  112.                     throw new ArgumentOutOfRangeException("index", Environment.GetResourceString("ArgumentOutOfRange_Index"));
  113.                 return InnerList[index];
  114.             }
  115.             set {
  116.                 if (index < 0 || index >= InnerList.Count)
  117.                     throw new ArgumentOutOfRangeException("index", Environment.GetResourceString("ArgumentOutOfRange_Index"));
  118.                 OnValidate(value);
  119.                 object temp = InnerList[index];
  120.                 OnSet(index, temp, value);
  121.                 InnerList[index] = value;
  122.                 try {
  123.                     OnSetComplete(index, temp, value);
  124.                 }
  125.                 catch {
  126.                     InnerList[index] = temp;
  127.                     throw;
  128.                 }
  129.             }
  130.         }
  131.        
  132.         bool IList.Contains(object value)
  133.         {
  134.             return InnerList.Contains(value);
  135.         }
  136.        
  137.         int IList.Add(object value)
  138.         {
  139.             OnValidate(value);
  140.             OnInsert(InnerList.Count, value);
  141.             int index = InnerList.Add(value);
  142.             try {
  143.                 OnInsertComplete(index, value);
  144.             }
  145.             catch {
  146.                 InnerList.RemoveAt(index);
  147.                 throw;
  148.             }
  149.             return index;
  150.         }
  151.        
  152.        
  153.         void IList.Remove(object value)
  154.         {
  155.             OnValidate(value);
  156.             int index = InnerList.IndexOf(value);
  157.             if (index < 0)
  158.                 throw new ArgumentException(Environment.GetResourceString("Arg_RemoveArgNotFound"));
  159.             OnRemove(index, value);
  160.             InnerList.RemoveAt(index);
  161.             try {
  162.                 OnRemoveComplete(index, value);
  163.             }
  164.             catch {
  165.                 InnerList.Insert(index, value);
  166.                 throw;
  167.             }
  168.         }
  169.        
  170.         int IList.IndexOf(object value)
  171.         {
  172.             return InnerList.IndexOf(value);
  173.         }
  174.        
  175.         void IList.Insert(int index, object value)
  176.         {
  177.             if (index < 0 || index > InnerList.Count)
  178.                 throw new ArgumentOutOfRangeException("index", Environment.GetResourceString("ArgumentOutOfRange_Index"));
  179.             OnValidate(value);
  180.             OnInsert(index, value);
  181.             InnerList.Insert(index, value);
  182.             try {
  183.                 OnInsertComplete(index, value);
  184.             }
  185.             catch {
  186.                 InnerList.RemoveAt(index);
  187.                 throw;
  188.             }
  189.         }
  190.        
  191.         public IEnumerator GetEnumerator()
  192.         {
  193.             return InnerList.GetEnumerator();
  194.         }
  195.        
  196.         protected virtual void OnSet(int index, object oldValue, object newValue)
  197.         {
  198.         }
  199.        
  200.         protected virtual void OnInsert(int index, object value)
  201.         {
  202.         }
  203.        
  204.         protected virtual void OnClear()
  205.         {
  206.         }
  207.        
  208.         protected virtual void OnRemove(int index, object value)
  209.         {
  210.         }
  211.        
  212.         protected virtual void OnValidate(object value)
  213.         {
  214.             if (value == null)
  215.                 throw new ArgumentNullException("value");
  216.         }
  217.        
  218.         protected virtual void OnSetComplete(int index, object oldValue, object newValue)
  219.         {
  220.         }
  221.        
  222.         protected virtual void OnInsertComplete(int index, object value)
  223.         {
  224.         }
  225.        
  226.         protected virtual void OnClearComplete()
  227.         {
  228.         }
  229.        
  230.         protected virtual void OnRemoveComplete(int index, object value)
  231.         {
  232.         }
  233.        
  234.     }
  235.    
  236. }

Developer Fusion