aboutsummaryrefslogtreecommitdiff
path: root/src/WixToolset.Core.Burn/Bind/ProvidesDependency.cs
blob: e64773b42b5d2df695e4c004040d779531e92718 (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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
// 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.Core.Burn
{
    using System;
    using System.Xml;
    using WixToolset.Data;

    /// <summary>
    /// Represents an authored or imported dependency provider.
    /// </summary>
    internal sealed class ProvidesDependency
    {
        /// <summary>
        /// Creates a new instance of the <see cref="ProviderDependency"/> class from a <see cref="Row"/>.
        /// </summary>
        /// <param name="row">The <see cref="Row"/> from which data is imported.</param>
        internal ProvidesDependency(Row row)
            : this((string)row[2], (string)row[3], (string)row[4], (int?)row[5])
        {
        }

        /// <summary>
        /// Creates a new instance of the <see cref="ProviderDependency"/> class.
        /// </summary>
        /// <param name="key">The unique key of the dependency.</param>
        /// <param name="attributes">Additional attributes for the dependency.</param>
        internal ProvidesDependency(string key, string version, string displayName, int? attributes)
        {
            this.Key = key;
            this.Version = version;
            this.DisplayName = displayName;
            this.Attributes = attributes;
        }

        /// <summary>
        /// Gets or sets the unique key of the package provider.
        /// </summary>
        internal string Key { get; set; }

        /// <summary>
        /// Gets or sets the version of the package provider.
        /// </summary>
        internal string Version { get; set; }

        /// <summary>
        /// Gets or sets the display name of the package provider.
        /// </summary>
        internal string DisplayName { get; set; }

        /// <summary>
        /// Gets or sets the attributes for the dependency.
        /// </summary>
        internal int? Attributes { get; set; }

        /// <summary>
        /// Gets or sets whether the dependency was imported from the package.
        /// </summary>
        internal bool Imported { get; set; }

        /// <summary>
        /// Gets whether certain properties are the same.
        /// </summary>
        /// <param name="other">Another <see cref="ProvidesDependency"/> to compare.</param>
        /// <remarks>This is not the same as object equality, but only checks a subset of properties
        /// to determine if the objects are similar and could be merged into a collection.</remarks>
        /// <returns>True if certain properties are the same.</returns>
        internal bool Equals(ProvidesDependency other)
        {
            if (null != other)
            {
                return this.Key == other.Key &&
                       this.Version == other.Version &&
                       this.DisplayName == other.DisplayName;
            }

            return false;
        }

        /// <summary>
        /// Writes the dependency to the bundle XML manifest.
        /// </summary>
        /// <param name="writer">The <see cref="XmlTextWriter"/> for the bundle XML manifest.</param>
        internal void WriteXml(XmlTextWriter writer)
        {
            writer.WriteStartElement("Provides");
            writer.WriteAttributeString("Key", this.Key);

            if (!String.IsNullOrEmpty(this.Version))
            {
                writer.WriteAttributeString("Version", this.Version);
            }

            if (!String.IsNullOrEmpty(this.DisplayName))
            {
                writer.WriteAttributeString("DisplayName", this.DisplayName);
            }

            if (this.Imported)
            {
                // The package dependency was explicitly authored into the manifest.
                writer.WriteAttributeString("Imported", "yes");
            }

            writer.WriteEndElement();
        }
    }
}