doc: 增加串口通信服务文档

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Samples/SerialPorts/SerialPortFactories.razor

@@ -0,0 +1,46 @@
+@page "/serial-port-factory"
+@inject IStringLocalizer<SerialPortFactories> Localizer
+
+<h3>SerialPort 串行通信服务 <code>ISerialPortFactory</code></h3>
+<h4>组件库内置了 SerialPort 串口通信服务</h4>
+
+<PackageTips Name="Longbow.SerialPort" />
+
+<Tips><div>特别注意：本服务不支持 <code>wasm</code> 模式</div></Tips>
+
+<p class="code-label">1. 服务注入</p>
+
+<Pre>services.AddSerialPortFactory();</Pre>
+
+<Pre>[Inject]
+[NotNull]
+private ISerialPortFactory? SerialPortFactory { get; set; }</Pre>
+
+<p class="code-label">2. 使用服务</p>
+<p>调用 <code>SerialPortFactory</code> 实例方法 <code>GetOrCreate</code> 即可得到一个 <code>ISerialPortClient</code> 实例。内部提供复用机制，调用两次得到的 <code>ISerialPortClient</code> 为同一对象</p>
+
+<p class="code-label">3. 通过工厂获得相对应协议 <code>ISerialPortClient</code> 实例</p>
+
+<p><code>ISerialPortFactory</code> 实例方法</p>
+
+<ul class="ul-demo">
+    <li>通过 <code>GetOrCreate</code> 获得 <code>ISerialPortClient</code> 实例</li>
+    <li>通过 <code>Remove</code> 移除指定名称的 <code>ISerialPortClient</code> 实例</li>
+</ul>
+
+<Pre>SerialPortFactory.Remove("test");</Pre>
+
+<p>可以通过注入服务直接获得 <code>ISerialPortClient</code> 实例</p>
+
+<Pre>[Inject]
+[NotNull]
+private ISerialPortClient? SerialPortClient { get; set; }</Pre>
+
+<p><code>ISerialPortClient</code> 实例方法</p>
+
+<ul class="ul-demo">
+    <li>打开端口方法 <code>OpenAsync</code></li>
+    <li>发送数据方法 <code>SendAsync</code></li>
+    <li>接收数据方法 <code>ReceiveAsync</code></li>
+    <li>关闭端口方法 <code>CloseAsync</code></li>
+</ul>

src/BootstrapBlazor.Server/Components/Samples/SerialPorts/SerialPortFactories.razor.cs

@@ -0,0 +1,14 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the Apache 2.0 License
+// See the LICENSE file in the project root for more information.
+// Maintainer: Argo Zhang([email protected]) Website: https://www.blazor.zone
+
+namespace BootstrapBlazor.Server.Components.Samples.SerialPorts;
+
+/// <summary>
+/// ISerialPortFactory 服务说明文档
+/// </summary>
+public partial class SerialPortFactories
+{
+
+}