SerialDevice 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示序列埠。 物件提供方法與屬性，讓應用程式可用來尋找和與系統上的序列埠互動。
public ref class SerialDevice sealed : IClosable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SerialDevice final : IClosable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SerialDevice : System.IDisposablePublic NotInheritable Class SerialDevice
Implements IDisposable- 繼承
- 屬性
- 實作
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
範例
using System;
using Windows.Devices.Enumeration;
using Windows.Devices.SerialCommunication;
using Windows.Storage.Streams;
...
DeviceInformationCollection serialDeviceInfos = await DeviceInformation.FindAllAsync(SerialDevice.GetDeviceSelector());
foreach (DeviceInformation serialDeviceInfo in serialDeviceInfos)
{
try
{
SerialDevice serialDevice = await SerialDevice.FromIdAsync(serialDeviceInfo.Id);
if (serialDevice != null)
{
// Found a valid serial device.
// Reading a byte from the serial device.
DataReader dr = new DataReader(serialDevice.InputStream);
int readByte = dr.ReadByte();
// Writing a byte to the serial device.
DataWriter dw = new DataWriter(serialDevice.OutputStream);
dw.WriteByte(0x42);
}
}
catch (Exception)
{
// Couldn't instantiate the device
}
}
備註
需要序列裝置功能 serialCommunication ，才能使用 SerialDevice 類別。 如需詳細資訊，請參閱 Windows.Devices.SerialCommunication。
建立 SerialDevice 物件
- 產生進階查詢語法 (AQS) 字串，其中包含搜尋準則，以尋找列舉裝置集合中的裝置。 如果您有廠商和產品識別碼，請呼叫 GetDeviceSelectorFromUsbVidPid。
- 將擷取的字串傳遞至 FindAllAsync。 呼叫會擷取 DeviceInformationCollection 物件。
- 迴圈查看集合。 每個反復專案都會取得 DeviceInformation 物件。
- 取得 DeviceInformation.Id 屬性值。 字串值是裝置介面路徑。 (例如
\\?\usb#vid_03eb&pid_2157&mi_01#7&1435ec7f&0&0001#{86e0d1e0-8089-11d0-9ce4-08003e301f73}) 。 - 傳遞裝置介面字串並取得
SerialDevice物件，以呼叫FromIdAsync。 如果這會擲回例外狀況或傳回 Null，則可能是：- 裝置介面路徑無效
- 裝置介面路徑不會重新呈現序列裝置
- 應用程式缺少
serialCommunication功能 - 無法存取序列裝置。 (請參閱 Windows.Devices.SerialCommunication)
讀取和寫入資料
然後，您可以使用 SerialDevice 物件，透過 Windows.Storage.Streams 命名空間讀取或寫入序列埠。
- 取得 SerialDevice.InputStream 屬性，以取得輸入資料流程的參考。
- 在 DataReader 建構函式中指定輸入資料流程，以建立 DataReader 物件。
- 取得 SerialDevice.OutputStream 屬性，以取得輸出資料流程的參考。
- 在 DataWriter 建構函式中指定輸出資料流程，以建立 DataWriter 物件。
屬性
| BaudRate |
取得或設定傳輸速率。 |
| BreakSignalState |
取得或設定中斷信號狀態。 |
| BytesReceived |
表示輸入資料流程的最後一個讀取作業所接收的位元組數目。 |
| CarrierDetectState |
取得「貨運公司偵測」 (CD) 行的狀態。 |
| ClearToSendState |
取得 Clear-to-Send (CTS) 行的狀態。 |
| DataBits |
傳輸或接收之每個字元值中的資料位數目，不包含同位位或停止位。 |
| DataSetReadyState |
取得 Data Set Ready (DSR) 信號的狀態。 |
| Handshake |
取得或設定流程式控制制的交握通訊協定。 |
| InputStream |
輸入資料流程，其中包含序列埠上收到的資料。 |
| IsDataTerminalReadyEnabled |
取得或設定值，這個值會啟用資料終端機就緒 (DTR) 訊號。 |
| IsRequestToSendEnabled |
取得或設定值，這個值可讓要求傳送 (RTS) 訊號。 |
| OutputStream |
取得輸出資料流程，應用程式可以寫入資料以透過序列埠傳輸。 |
| Parity |
取得或設定錯誤檢查的同位。 |
| PortName |
取得序列通訊的埠名稱。 |
| ReadTimeout |
取得或設定讀取作業的逾時值。 |
| StopBits |
取得或設定每個位元組的標準停止位數目。 |
| UsbProductId |
取得USB 裝置描述項的idProduct欄位。 此值表示裝置特定的產品識別碼，並由製造商指派。 |
| UsbVendorId |
取得USB 裝置描述項的idVendor欄位。 值表示裝置的廠商識別碼，由 USB 規格委員會指派。 |
| WriteTimeout |
取得或設定寫入作業的逾時值。 |
方法
| Close() |
釋放先前透過呼叫FromIdAsync取得之SerialDevice物件的參考。 |
| Dispose() |
執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 |
| FromIdAsync(String) |
啟動建立 SerialDevice 物件的非同步作業。 |
| GetDeviceSelector() |
取得進階查詢語法 (AQS) 字串，應用程式可以傳遞至 DeviceInformation.FindAllAsync ，以尋找系統上的所有序列裝置。 |
| GetDeviceSelector(String) |
取得進階查詢語法 (AQS) 字串，應用程式可以傳遞至 DeviceInformation.FindAllAsync ，以指定其埠名稱來尋找序列裝置。 |
| GetDeviceSelectorFromUsbVidPid(UInt16, UInt16) |
取得進階查詢語法 (AQS) 字串，應用程式可以傳遞至 DeviceInformation.FindAllAsync ，藉由指定其 VID 和 PID 來尋找特定的串列到 USB 裝置。 |
事件
| ErrorReceived |
在序列埠發生錯誤時叫用的事件處理常式。 |
| PinChanged |
當訊號或行的狀態在序列埠上變更時所叫用的事件處理常式。 |