aboutsummaryrefslogtreecommitdiff
path: root/src/WixToolset.Core/Link/ConnectToModuleCollection.cs
blob: 6595487fde100e1adcc8aff70ae90407b7668096 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.

namespace WixToolset.Link
{
    using System;
    using System.Collections;

    /// <summary>
    /// Hash collection of connect to module objects.
    /// </summary>
    public sealed class ConnectToModuleCollection : ICollection
    {
        private Hashtable collection;

        /// <summary>
        /// Instantiate a new ConnectToModuleCollection class.
        /// </summary>
        public ConnectToModuleCollection()
        {
            this.collection = new Hashtable();
        }

        /// <summary>
        /// Gets the number of elements actually contained in the ConnectToModuleCollection.
        /// </summary>
        /// <value>The number of elements actually contained in the ConnectToModuleCollection.</value>
        public int Count
        {
            get { return this.collection.Count; }
        }

        /// <summary>
        /// Gets a value indicating whether access to the ConnectToModuleCollection is synchronized (thread-safe).
        /// </summary>
        /// <value>true if access to the ConnectToModuleCollection is synchronized (thread-safe); otherwise, false. The default is false.</value>
        public bool IsSynchronized
        {
            get { return this.collection.IsSynchronized; }
        }

        /// <summary>
        /// Gets an object that can be used to synchronize access to the ConnectToModuleCollection.
        /// </summary>
        /// <value>An object that can be used to synchronize access to the ConnectToModuleCollection.</value>
        public object SyncRoot
        {
            get { return this.collection.SyncRoot; }
        }

        /// <summary>
        /// Gets a module connection by child id.
        /// </summary>
        /// <param name="childId">Identifier of child to locate.</param>
        public ConnectToModule this[string childId]
        {
            get { return (ConnectToModule)this.collection[childId]; }
        }

        /// <summary>
        /// Adds a module connection to the collection.
        /// </summary>
        /// <param name="connection">Module connection to add.</param>
        public void Add(ConnectToModule connection)
        {
            if (null == connection)
            {
                throw new ArgumentNullException("connection");
            }

            this.collection.Add(connection.ChildId, connection);
        }

        /// <summary>
        /// Copies the entire ConnectToModuleCollection to a compatible one-dimensional Array, starting at the specified index of the target array.
        /// </summary>
        /// <param name="array">The one-dimensional Array that is the destination of the elements copied from this ConnectToModuleCollection. The Array must have zero-based indexing.</param>
        /// <param name="index">The zero-based index in array at which copying begins.</param>
        public void CopyTo(System.Array array, int index)
        {
            this.collection.Keys.CopyTo(array, index);
        }

        /// <summary>
        /// Returns an enumerator for the entire ConnectToModuleCollection.
        /// </summary>
        /// <returns>An IEnumerator for the entire ConnectToModuleCollection.</returns>
        public IEnumerator GetEnumerator()
        {
            return this.collection.Keys.GetEnumerator();
        }
    }
}