add validate method for serial port name.

Author: seayxu

src/GodSharp.SerialPort/Core/GodSerialPort.Static.cs

@@ -1,5 +1,7 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
 using System.IO.Ports;
+using System.Text.RegularExpressions;
 
 // ReSharper disable All
 namespace GodSharp.SerialPort
@@ -9,6 +11,63 @@ namespace GodSharp.SerialPort
     /// </summary>
     public partial class GodSerialPort
     {
+
+        /// <summary>
+        /// Get an array of serialport name for current computer.
+        /// </summary>
+        /// <returns></returns>
+        public static string[] GetPortNames() => System.IO.Ports.SerialPort.GetPortNames();
+
+        /// <summary>
+        /// Validate prot name.
+        /// </summary>
+        /// <param name="name">The name of serial port.</param>
+        /// <param name="throwException">weather throw exception.default is false.</param>
+        /// <returns></returns>
+        /// <exception cref="ArgumentException"></exception>
+        public static bool ValidatePortName(string name,bool throwException=false)
+        {
+#if NET35
+            if (string.IsNullOrEmpty(name) || name?.Trim()=="")
+#else
+            if (string.IsNullOrWhiteSpace(name))
+#endif
+            {
+                if (throwException)
+                {
+                    return false;
+                }
+                
+                throw new ArgumentNullException(nameof(name));
+            }
+            
+            Regex regx = new Regex("^COM([0-9]{1,})$", RegexOptions.IgnoreCase);
+            if (!regx.IsMatch(name))
+            {
+                if (throwException)
+                {
+                    return false;
+                }
+                
+                throw new ArgumentException("port name must be COMxx.", nameof(name));
+            }
+
+            Match match = regx.Match(name);
+            bool b = int.TryParse(match.Groups[1].Value, out int v);
+
+            if (!b || v < 1)
+            {
+                if (throwException)
+                {
+                    return false;
+                }
+                
+                throw new ArgumentException("port name must be COMxx.", nameof(name));
+            }
+
+            return true;
+        }
+        
         /// <summary>
         /// Gets the baudrate dictionary.
         /// </summary>

src/GodSharp.SerialPort/Core/GodSerialPort.cs

@@ -543,21 +543,9 @@ private void Init()
         {
             try
             {
-                portName = portName?.Trim() ?? throw new ArgumentNullException(nameof(portName));
+                portName = portName?.Trim();
 
-                Regex regx = new Regex("^COM([0-9]{1,})$", RegexOptions.IgnoreCase);
-                if (!regx.IsMatch(portName))
-                {
-                    throw new ArgumentException("port name must be COMxx.", nameof(portName));
-                }
-
-                Match match = regx.Match(portName);
-                bool b = int.TryParse(match.Groups[1].Value, out int v);
-
-                if (!b || v < 1)
-                {
-                    throw new ArgumentException("port name must be COMxx.", nameof(portName));
-                }
+                ValidatePortName(portName);
 
                 serialPort.PortName = portName;
                 serialPort.BaudRate = baudRate;
@@ -911,12 +899,6 @@ public int Write(byte[] bytes, int offset, int count)
         /// Discards the output buffer.
         /// </summary>
         public void DiscardOutBuffer() => serialPort.DiscardOutBuffer();
-
-        /// <summary>
-        /// Get an array of serialport name for current computer.
-        /// </summary>
-        /// <returns></returns>
-        public static string[] GetPortNames() => System.IO.Ports.SerialPort.GetPortNames();
         #endregion
     }
 }

src/GodSharp.SerialPort/GodSharp.SerialPort.csproj

@@ -1,14 +1,13 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <AssemblyVersion>1.2.0.1</AssemblyVersion>
-    <AssemblyFileVersion>1.2.0.1</AssemblyFileVersion>
+    <AssemblyVersion>1.2.0.2</AssemblyVersion>
+    <AssemblyFileVersion>1.2.0.2</AssemblyFileVersion>
     <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <NeutralLanguage>en-US</NeutralLanguage>
     <Title>GodSharp.SerialPort</Title>
     <PackageId>GodSharp.SerialPort</PackageId>
     <PackageTags>GodSharp,GodSharp.SerialPort,SerialPort</PackageTags>
-    <PackageReleaseNotes>support netstandard2.0.</PackageReleaseNotes>
     <Company>GodSharp</Company>
     <Authors>seayxu</Authors>
     <Description>An easy-to-use .NET SerialPort Library.</Description>
@@ -18,7 +17,7 @@
     <Copyright>Copyright © GodSharp 2017</Copyright>
     <PackageIconUrl>https://avatars3.githubusercontent.com/u/26563296</PackageIconUrl>
     <PackageLicenseUrl>https://github.com/godsharp/GodSharp.SerialPort/blob/master/LICENSE</PackageLicenseUrl>
-    <Version>1.2.0-preview1</Version>
+    <Version>1.2.0-preview2</Version>
     <TargetFrameworks Condition="'$(LibraryFrameworks)'==''">netstandard2.0;net47;net46;net452;net451;net45;net40;net35;</TargetFrameworks>
     <TargetFrameworks Condition="'$(LibraryFrameworks)'!=''">$(LibraryFrameworks)</TargetFrameworks>
     <ApplicationIcon />