Better search versions error experience

[Forgind]

If you try dotnet workload search version and then put anything after that that it doesn't recognize, it assumes it's a workload version argument. Often, it isn't. For instance, dotnet workload search version --include-previews tries to parse --include-previews as a version incorrectly, fails, and throws a garbage error. This makes the error experience more useful.

[dotnet-policy-service]

Thanks for your PR, @Forgind.
To learn about the PR process and branching schedule of this repo, please take a look at the SDK PR Guide.

[KalleOlaviNiemitalo]

This workaround would not be needed if dotnet/command-line-api#1860 were fixed.

[Forgind]

The first few lines here are duplicated from below, but they can't really be de-duped, as they are just defining variables. The variables would need to be defined either way.

[MiYanni]

nit: Combine nested boolean conditions

Suggested change

	if (versionArgument is not null)
	{
	if (!WorkloadSetVersion.IsWorkloadSetPackageVersion(versionArgument))
	{
	result.AddError(string.Format(CommandLineValidation.LocalizableStrings.UnrecognizedCommandOrArgument, versionArgument));
	}
	}
	if (versionArgument is not null &&
	!WorkloadSetVersion.IsWorkloadSetPackageVersion(versionArgument))
	{
	result.AddError(string.Format(CommandLineValidation.LocalizableStrings.UnrecognizedCommandOrArgument, versionArgument));
	}

[MiYanni]

Deduplicated the code. Also, noticed preReleaseOrBuild is unused in IsWorkloadSetPackageVersion. I cannot do a suggestion block since I cannot highlight the bottom of the ToWorkloadSetPackageVersion method in GitHub to include in this comment.

        private static string[] SeparateCoreComponents(string workloadSetVersion, out string[] sections)
        {
            sections = workloadSetVersion.Split(['-', '+'], 2);
            return sections[0].Split('.');
        }

        public static bool IsWorkloadSetPackageVersion(string workloadSetVersion)
        {
            string[] coreComponents = SeparateCoreComponents(workloadSetVersion, out _);
            return coreComponents.Length >= 3 && coreComponents.Length <= 4;
        }

        public static string ToWorkloadSetPackageVersion(string workloadSetVersion, out SdkFeatureBand sdkFeatureBand)
        {
            string[] coreComponents = SeparateCoreComponents(workloadSetVersion, out string[] sections);
            string major = coreComponents[0];
            string minor = coreComponents[1];
            string patch = coreComponents[2];
            string packageVersion = $"{major}.{patch}.";
            if (coreComponents.Length == 3)
            {
                //  No workload set patch version
                packageVersion += "0";
                //  Use preview specifier (if any) from workload set version as part of SDK feature band
                sdkFeatureBand = new SdkFeatureBand(workloadSetVersion);
            }
            else
            {
                //  Workload set version has workload patch version (ie 4 components)
                packageVersion += coreComponents[3];
                //  Don't include any preview specifiers in SDK feature band
                sdkFeatureBand = new SdkFeatureBand($"{major}.{minor}.{patch}");
            }

            if (sections.Length > 1)
            {
                //  Figure out if we split on a '-' or '+'
                char separator = workloadSetVersion[sections[0].Length];
                packageVersion += separator + sections[1];
            }
            return packageVersion;
        }