src/Microsoft.PowerShell.Commands.Utility/commands/utility/WebCmdlet/WebCmdletElementCollection.cs - master - githubmirror/PowerShell

src/Microsoft.PowerShell.Commands.Utility/commands/utility/WebCmdlet/WebCmdletElementCollection.cs

56 строк2 KB

CarloToso

Enable more nullable annotations in WebCmdlets (#19359)

24 апр 2023, 06:38

24 апр 2023, 06:38543b20b

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

#nullable enable

using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Management.Automation;

namespace Microsoft.PowerShell.Commands
{
    /// <summary>
    /// WebCmdletElementCollection for elements in html web responses.
    /// </summary>
    public class WebCmdletElementCollection : ReadOnlyCollection<PSObject>
    {
        internal WebCmdletElementCollection(IList<PSObject> list) : base(list)
        {
        }

        /// <summary>
        /// Finds the element with name or id.
        /// </summary>
        /// <param name="nameOrId"></param>
        /// <returns>Found element as PSObject.</returns>
        public PSObject? Find(string nameOrId) => FindById(nameOrId) ?? FindByName(nameOrId);

        /// <summary>
        /// Finds the element by id.
        /// </summary>
        /// <param name="id"></param>
        /// <returns>Found element as PSObject.</returns>
        public PSObject? FindById(string id) => Find(id, findById: true);

        /// <summary>
        /// Finds the element by name.
        /// </summary>
        /// <param name="name"></param>
        /// <returns>Found element as PSObject.</returns>
        public PSObject? FindByName(string name) => Find(name, findById: false);

        private PSObject? Find(string nameOrId, bool findById)
        {
            foreach (PSObject candidate in this)
            {
                var namePropInfo = candidate.Properties[(findById ? "id" : "name")];
                if (namePropInfo != null && (string)namePropInfo.Value == nameOrId)
                {
                    return candidate;
                }
            }

            return null;
        }
    }
}