/// <overloads>
/// Adds a range of elements to the end of the <see cref="TrackCollection"/>.
/// </overloads>
/// <summary>
/// Adds the elements of another collection to the end of the <see cref="TrackCollection"/>.
/// </summary>
/// <param name="collection">The <see cref="TrackCollection"/> whose elements
/// should be added to the end of the current collection.</param>
/// <exception cref="ArgumentNullException">
/// <paramref name="collection"/> is a null reference.</exception>
/// <exception cref="NotSupportedException">
/// <para>The <see cref="TrackCollection"/> is read-only.</para>
/// <para>-or-</para>
/// <para>The <b>TrackCollection</b> has a fixed size.</para>
/// <para>-or-</para>
/// <para>The <b>TrackCollection</b> already contains one or more elements
/// in the specified <paramref name="collection"/>, and the <b>TrackCollection</b>
/// ensures that all elements are unique.</para></exception>
/// <remarks>Please refer to <see cref="ArrayList.AddRange"/> for details.</remarks>
public virtual void AddRange(TrackCollection collection)
{
if (collection == null)
throw new ArgumentNullException("collection");
if (collection.Count == 0) return;
if (this._count + collection.Count > this._array.Length)
EnsureCapacity(this._count + collection.Count);
++this._version;
Array.Copy(collection.InnerArray, 0,
this._array, this._count, collection.Count);
this._count += collection.Count;
}
/// <summary>
/// Creates a shallow copy of the <see cref="TrackCollection"/>.
/// </summary>
/// <returns>A shallow copy of the <see cref="TrackCollection"/>.</returns>
/// <remarks>Please refer to <see cref="ArrayList.Clone"/> for details.</remarks>
public virtual object Clone()
{
TrackCollection collection = new TrackCollection(this._count);
Array.Copy(this._array, 0, collection._array, 0, this._count);
collection._count = this._count;
collection._version = this._version;
return collection;
}
public override void AddRange(TrackCollection collection)
{
foreach (Track value in collection)
CheckUnique(value);
this._collection.AddRange(collection);
}
/// <summary>
/// Initializes a new instance of the <see cref="TrackCollection"/> class
/// that contains elements copied from the specified collection and
/// that has the same initial capacity as the number of elements copied.
/// </summary>
/// <param name="collection">The <see cref="TrackCollection"/>
/// whose elements are copied to the new collection.</param>
/// <exception cref="ArgumentNullException">
/// <paramref name="collection"/> is a null reference.</exception>
/// <remarks>Please refer to <see cref="ArrayList(ICollection)"/> for details.</remarks>
public TrackCollection(TrackCollection collection)
{
if (collection == null)
throw new ArgumentNullException("collection");
this._array = new Track[collection.Count];
AddRange(collection);
}
public override void AddRange(TrackCollection collection)
{
lock (this._root) this._collection.AddRange(collection);
}
internal UniqueList(TrackCollection collection)
:
base(Tag.Default)
{
this._collection = collection;
}
public override void AddRange(TrackCollection collection)
{
throw new NotSupportedException(
"Read-only collections cannot be modified.");
}
internal SyncList(TrackCollection collection)
:
base(Tag.Default)
{
this._root = collection.SyncRoot;
this._collection = collection;
}
internal ReadOnlyList(TrackCollection collection)
:
base(Tag.Default)
{
this._collection = collection;
}
internal Enumerator(TrackCollection collection)
{
this._collection = collection;
this._version = collection._version;
this._index = -1;
}
/// <summary>
/// Returns a wrapper for the specified <see cref="TrackCollection"/>
/// ensuring that all elements are unique.
/// </summary>
/// <param name="collection">The <see cref="TrackCollection"/> to wrap.</param>
/// <returns>
/// A wrapper around <paramref name="collection"/> ensuring that all elements are unique.
/// </returns>
/// <exception cref="ArgumentException">
/// <paramref name="collection"/> contains duplicate elements.</exception>
/// <exception cref="ArgumentNullException">
/// <paramref name="collection"/> is a null reference.</exception>
/// <remarks><para>
/// The <b>Unique</b> wrapper provides a set-like collection by ensuring
/// that all elements in the <see cref="TrackCollection"/> are unique.
/// </para><para>
/// <b>Unique</b> raises an <see cref="ArgumentException"/> if the specified
/// <paramref name="collection"/> contains any duplicate elements. The returned
/// wrapper raises a <see cref="NotSupportedException"/> whenever the user attempts
/// to add an element that is already contained in the <b>TrackCollection</b>.
/// </para><para>
/// <strong>Note:</strong> The <b>Unique</b> wrapper reflects any changes made
/// to the underlying <paramref name="collection"/>, including the possible
/// creation of duplicate elements. The uniqueness of all elements is therefore
/// no longer assured if the underlying collection is manipulated directly.
/// </para></remarks>
public static TrackCollection Unique(TrackCollection collection)
{
if (collection == null)
throw new ArgumentNullException("collection");
for (int i = collection.Count - 1; i > 0; i--)
if (collection.IndexOf(collection[i]) < i)
throw new ArgumentException("collection",
"Argument cannot contain duplicate elements.");
return new UniqueList(collection);
}
/// <summary>
/// Returns a synchronized (thread-safe) wrapper
/// for the specified <see cref="TrackCollection"/>.
/// </summary>
/// <param name="collection">The <see cref="TrackCollection"/> to synchronize.</param>
/// <returns>
/// A synchronized (thread-safe) wrapper around <paramref name="collection"/>.
/// </returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="collection"/> is a null reference.</exception>
/// <remarks>Please refer to <see cref="ArrayList.Synchronized"/> for details.</remarks>
public static TrackCollection Synchronized(TrackCollection collection)
{
if (collection == null)
throw new ArgumentNullException("collection");
return new SyncList(collection);
}
/// <summary>
/// Returns a read-only wrapper for the specified <see cref="TrackCollection"/>.
/// </summary>
/// <param name="collection">The <see cref="TrackCollection"/> to wrap.</param>
/// <returns>A read-only wrapper around <paramref name="collection"/>.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="collection"/> is a null reference.</exception>
/// <remarks>Please refer to <see cref="ArrayList.ReadOnly"/> for details.</remarks>
public static TrackCollection ReadOnly(TrackCollection collection)
{
if (collection == null)
throw new ArgumentNullException("collection");
return new ReadOnlyList(collection);
}