PowerShell/src/System.Management.Automation/engine/MshSnapinQualifiedName.cs at master · roachhd/PowerShell · GitHub

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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
/********************************************************************++
Copyright (c) Microsoft Corporation.  All rights reserved.
--********************************************************************/

using Dbg = System.Management.Automation.Diagnostics;

namespace System.Management.Automation
{
    /// <summary>
    /// A class respresenting a name that is qualified by the PSSnapin name
    /// </summary>
    internal class PSSnapinQualifiedName
    {
        private PSSnapinQualifiedName(string[] splitName)
        {
            Dbg.Assert(splitName != null, "splitName should not be null");
            Dbg.Assert(splitName.Length == 1 || splitName.Length == 2, "splitName should contain 1 or 2 elements");

            if (splitName.Length == 1)
            {
                _shortName = splitName[0];
            }
            else if (splitName.Length == 2)
            {
                if (!String.IsNullOrEmpty(splitName[0]))
                {
                    _psSnapinName = splitName[0];
                }

                _shortName = splitName[1];
            }
            else
            {
                // Since the provider name contained multiple slashes it is
                // a bad format.

                throw PSTraceSource.NewArgumentException("name");
            }

            // Now set the full name

            if (!String.IsNullOrEmpty(_psSnapinName))
            {
                _fullName =
                    String.Format(
                        System.Globalization.CultureInfo.InvariantCulture,
                        "{0}\\{1}",
                        _psSnapinName,
                        _shortName);
            }
            else
            {
                _fullName = _shortName;
            }
        }

        /// <summary>
        /// Gets an instance of the Name class.
        /// </summary>
        ///
        /// <param name="name">
        /// The name of the command.
        /// </param>
        ///
        /// <returns>
        /// An instance of the Name class.
        /// </returns>
        ///
        internal static PSSnapinQualifiedName GetInstance(string name)
        {
            if (name == null)
                return null;
            PSSnapinQualifiedName result = null;
            string[] splitName = name.Split(Utils.Separators.Backslash);
            if (splitName.Length < 0 || splitName.Length > 2)
                return null;
            result = new PSSnapinQualifiedName(splitName);
            // If the shortname is empty, then return null...
            if (String.IsNullOrEmpty(result.ShortName))
            {
                return null;
            }

            return result;
        }

        /// <summary>
        /// Gets the command's full name.
        /// </summary>
        ///
        internal string FullName
        {
            get
            {
                return _fullName;
            }
        }
        private string _fullName;

        /// <summary>
        /// Gets the command's PSSnapin name.
        /// </summary>
        ///
        internal string PSSnapInName
        {
            get
            {
                return _psSnapinName;
            }
        }
        private string _psSnapinName;

        /// <summary>
        /// Gets the command's short name.
        /// </summary>
        ///
        internal string ShortName
        {
            get
            {
                return _shortName;
            }
        }
        private string _shortName;

        /// <summary>
        /// The full name
        /// </summary>
        ///
        /// <returns>
        /// A string representing the full name.
        /// </returns>
        ///
        public override string ToString()
        {
            return _fullName;
        }
    }
}