SerialPort 类
表示串行端口资源。
命名空间: System.IO.Ports
程序集: System(在 System.dll 中)
SerialPort 类型公开以下成员。
名称 | 说明 | |
---|---|---|
SerialPort() | 初始化 SerialPort 类的新实例。 | |
SerialPort(IContainer) | 使用指定的 IContainer 对象初始化 SerialPort 类的新实例。 | |
SerialPort(String) | 使用指定的端口名称初始化 SerialPort 类的新实例。 | |
SerialPort(String, Int32) | 使用指定的端口名称和波特率初始化 SerialPort 类的新实例。 | |
SerialPort(String, Int32, Parity) | 使用指定的端口名称、波特率和奇偶校验位初始化 SerialPort 类的新实例。 | |
SerialPort(String, Int32, Parity, Int32) | 使用指定的端口名称、波特率、校验位和数据位初始化 SerialPort 类的新实例。 | |
SerialPort(String, Int32, Parity, Int32, StopBits) | 使用指定的端口名称、波特率、奇偶校验位、数据位和停止位初始化SerialPort 类的新实例。 |
名称 | 说明 | |
---|---|---|
BaseStream | 获取 SerialPort 对象的基础 Stream 对象。 | |
BaudRate | 获取或设置串行波特率。 | |
BreakState | 获取或设置中断信号状态。 | |
BytesToRead | 获取接收缓冲区中数据的字节数。 | |
BytesToWrite | 获取发送缓冲区中数据的字节数。 | |
CanRaiseEvents | 获取一个指示组件是否可以引发事件的值。 (继承自 Component。) | |
CDHolding | 获取端口的载波检测行的状态。 | |
Container | 获取 IContainer,它包含 Component。 (继承自 Component。) | |
CtsHolding | 获取“可以发送”行的状态。 | |
DataBits | 获取或设置每个字节的标准数据位长度。 | |
DesignMode | 获取一个值,用以指示 Component 当前是否处于设计模式。 (继承自Component。) | |
DiscardNull | 获取或设置一个值,该值指示 Null 字节在端口和接收缓冲区之间传输时是否被忽略。 | |
DsrHolding | 获取数据设置就绪 (DSR) 信号的状态。 | |
DtrEnable | 获取或设置一个值,该值在串行通信过程中启用数据终端就绪 (DTR) 信号。 | |
Encoding | 获取或设置传输前后文本转换的字节编码。 | |
Events | 获取附加到此 Component 的事件处理程序的列表。 (继承自 Component。) | |
Handshake | 获取或设置串行端口数据传输的握手协议。 | |
IsOpen | 获取一个值,该值指示 SerialPort 对象的打开或关闭状态。 | |
NewLine | 获取或设置用于解释 ReadLine 和 WriteLine 方法调用结束的值。 | |
Parity | 获取或设置奇偶校验检查协议。 | |
ParityReplace | 获取或设置一个字节,该字节在发生奇偶校验错误时替换数据流中的无效字节。 | |
PortName | 获取或设置通信端口,包括但不限于所有可用的 COM 端口。 | |
ReadBufferSize | 获取或设置 SerialPort 输入缓冲区的大小。 | |
ReadTimeout | 获取或设置读取操作未完成时发生超时之前的毫秒数。 | |
ReceivedBytesThreshold | 获取或设置 DataReceived 事件发生前内部输入缓冲区中的字节数。 | |
RtsEnable | 获取或设置一个值,该值指示在串行通信中是否启用请求发送 (RTS) 信号。 | |
Site | 获取或设置 Component 的 ISite。 (继承自 Component。) | |
StopBits | 获取或设置每个字节的标准停止位数。 | |
WriteBufferSize | 获取或设置串行端口输出缓冲区的大小。 | |
WriteTimeout | 获取或设置写入操作未完成时发生超时之前的毫秒数。 |
名称 | 说明 | |
---|---|---|
Close | 关闭端口连接,将 IsOpen 属性设置为 false,并释放内部 Stream 对象。 | |
CreateObjRef | 创建一个对象,该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject。) | |
DiscardInBuffer | 丢弃来自串行驱动程序的接收缓冲区的数据。 | |
DiscardOutBuffer | 丢弃来自串行驱动程序的传输缓冲区的数据。 | |
Dispose() | 释放由 Component 使用的所有资源。 (继承自 Component。) | |
Dispose(Boolean) | 释放由 SerialPort 占用的非托管资源,还可以另外再释放托管资源。 (重写Component.Dispose(Boolean)。) | |
Equals(Object) | 确定指定的对象是否等于当前对象。 (继承自 Object。) | |
Finalize | 在通过垃圾回收将 Component 回收之前,释放非托管资源并执行其他清理操作。(继承自 Component。) | |
GetHashCode | 作为默认哈希函数。 (继承自 Object。) | |
GetLifetimeService | 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自MarshalByRefObject。) | |
GetPortNames | 获取当前计算机的串行端口名称数组。 | |
GetService | 返回一个对象,该对象表示由 Component 或它的 Container 提供的服务。 (继承自 Component。) | |
GetType | 获取当前实例的 Type。 (继承自 Object。) | |
InitializeLifetimeService | 获取控制此实例的生存期策略的生存期服务对象。 (继承自MarshalByRefObject。) | |
MemberwiseClone() | 创建当前 Object 的浅表副本。 (继承自 Object。) | |
MemberwiseClone(Boolean) | 创建当前 MarshalByRefObject 对象的浅表副本。 (继承自MarshalByRefObject。) | |
Open | 打开一个新的串行端口连接。 | |
Read(Byte[], Int32, Int32) | 从 SerialPort 输入缓冲区读取一些字节并将那些字节写入字节数组中指定的偏移量处。 | |
Read(Char[], Int32, Int32) | 从 SerialPort 输入缓冲区中读取大量字符,然后将这些字符写入到一个字符数组中指定的偏移量处。 | |
ReadByte | 从 SerialPort 输入缓冲区中同步读取一个字节。 | |
ReadChar | 从 SerialPort 输入缓冲区中同步读取一个字符。 | |
ReadExisting | 在编码的基础上,读取 SerialPort 对象的流和输入缓冲区中所有立即可用的字节。 | |
ReadLine | 一直读取到输入缓冲区中的 NewLine 值。 | |
ReadTo | 一直读取到输入缓冲区中的指定 value 的字符串。 | |
ToString | 返回包含 Component 的名称的 String(如果有)。 不应重写此方法。 (继承自Component。) | |
Write(String) | 将指定的字符串写入串行端口。 | |
Write(Byte[], Int32, Int32) | 使用缓冲区的数据将指定数量的字节写入串行端口。 | |
Write(Char[], Int32, Int32) | 使用缓冲区的数据将指定数量的字符写入串行端口。 | |
WriteLine | 将指定的字符串和 NewLine 值写入输出缓冲区。 |
名称 | 说明 | |
---|---|---|
DataReceived | 表示将处理 SerialPort 对象的数据接收事件的方法。 | |
Disposed | 当通过调用 Dispose 方法释放组件时发生。 (继承自 Component。) | |
ErrorReceived | 表示处理 SerialPort 对象的错误事件的方法。 | |
PinChanged | 表示将处理 SerialPort 对象的串行管脚更改事件的方法。 |
此类用于控制串行端口文件资源。 此类提供同步 I/O 和事件驱动的 I/O、对管脚和中断状态的访问以及对串行驱动程序属性的访问。 另外,此类的功能可以包装在内部 Stream 对象中,可通过 BaseStream 属性访问,并且可以传递给包装或使用流的类。
SerialPort 选件类支持以下编码:ASCIIEncoding、UTF8Encoding、UnicodeEncoding、UTF32Encoding以及代码页的 mscorlib.dll 中定义的任何编码表示小于 50000 或代码页是 54936。可以使用备用编码,但是,您必须使用 ReadByte 或 Write 方法和执行编码。
您使用 GetPortNames 方法检索当前计算机的有效的端口。
如果 SerialPort 对象在一次读取操作时被阻止,不要中止线程。 相反,关闭基础流或部署SerialPort 对象。
下面的代码示例演示如何使用 SerialPort 类以允许两位用户分别在两台通过 NULL 调制解调器电缆连接的独立计算机上聊天。 本示例中,在聊天之前将提示用户输入端口设置和用户名。 这两台计算机必须同时执行该程序才能实现本示例的全部功能。
using System; using System.IO.Ports; using System.Threading; public class PortChat { static bool _continue; static SerialPort _serialPort; public static void Main() { string name; string message; StringComparer stringComparer = StringComparer.OrdinalIgnoreCase; Thread readThread = new Thread(Read); // Create a new SerialPort object with default settings. _serialPort = new SerialPort(); // Allow the user to set the appropriate properties. _serialPort.PortName = SetPortName(_serialPort.PortName); _serialPort.BaudRate = SetPortBaudRate(_serialPort.BaudRate); _serialPort.Parity = SetPortParity(_serialPort.Parity); _serialPort.DataBits = SetPortDataBits(_serialPort.DataBits); _serialPort.StopBits = SetPortStopBits(_serialPort.StopBits); _serialPort.Handshake = SetPortHandshake(_serialPort.Handshake); // Set the read/write timeouts _serialPort.ReadTimeout = 500; _serialPort.WriteTimeout = 500; _serialPort.Open(); _continue = true; readThread.Start(); Console.Write("Name: "); name = Console.ReadLine(); Console.WriteLine("Type QUIT to exit"); while (_continue) { message = Console.ReadLine(); if (stringComparer.Equals("quit", message)) { _continue = false; } else { _serialPort.WriteLine( String.Format("<{0}>: {1}", name, message)); } } readThread.Join(); _serialPort.Close(); } public static void Read() { while (_continue) { try { string message = _serialPort.ReadLine(); Console.WriteLine(message); } catch (TimeoutException) { } } } // Display Port values and prompt user to enter a port. public static string SetPortName(string defaultPortName) { string portName; Console.WriteLine("Available Ports:"); foreach (string s in SerialPort.GetPortNames()) { Console.WriteLine(" {0}", s); } Console.Write("Enter COM port value (Default: {0}): ", defaultPortName); portName = Console.ReadLine(); if (portName == "" || !(portName.ToLower()).StartsWith("com")) { portName = defaultPortName; } return portName; } // Display BaudRate values and prompt user to enter a value. public static int SetPortBaudRate(int defaultPortBaudRate) { string baudRate; Console.Write("Baud Rate(default:{0}): ", defaultPortBaudRate); baudRate = Console.ReadLine(); if (baudRate == "") { baudRate = defaultPortBaudRate.ToString(); } return int.Parse(baudRate); } // Display PortParity values and prompt user to enter a value. public static Parity SetPortParity(Parity defaultPortParity) { string parity; Console.WriteLine("Available Parity options:"); foreach (string s in Enum.GetNames(typeof(Parity))) { Console.WriteLine(" {0}", s); } Console.Write("Enter Parity value (Default: {0}):", defaultPortParity.ToString(), true); parity = Console.ReadLine(); if (parity == "") { parity = defaultPortParity.ToString(); } return (Parity)Enum.Parse(typeof(Parity), parity, true); } // Display DataBits values and prompt user to enter a value. public static int SetPortDataBits(int defaultPortDataBits) { string dataBits; Console.Write("Enter DataBits value (Default: {0}): ", defaultPortDataBits); dataBits = Console.ReadLine(); if (dataBits == "") { dataBits = defaultPortDataBits.ToString(); } return int.Parse(dataBits.ToUpperInvariant()); } // Display StopBits values and prompt user to enter a value. public static StopBits SetPortStopBits(StopBits defaultPortStopBits) { string stopBits; Console.WriteLine("Available StopBits options:"); foreach (string s in Enum.GetNames(typeof(StopBits))) { Console.WriteLine(" {0}", s); } Console.Write("Enter StopBits value (None is not supported and \n" + "raises an ArgumentOutOfRangeException. \n (Default: {0}):", defaultPortStopBits.ToString()); stopBits = Console.ReadLine(); if (stopBits == "" ) { stopBits = defaultPortStopBits.ToString(); } return (StopBits)Enum.Parse(typeof(StopBits), stopBits, true); } public static Handshake SetPortHandshake(Handshake defaultPortHandshake) { string handshake; Console.WriteLine("Available Handshake options:"); foreach (string s in Enum.GetNames(typeof(Handshake))) { Console.WriteLine(" {0}", s); } Console.Write("End Handshake value (Default: {0}):", defaultPortHandshake.ToString()); handshake = Console.ReadLine(); if (handshake == "") { handshake = defaultPortHandshake.ToString(); } return (Handshake)Enum.Parse(typeof(Handshake), handshake, true); } }
- SecurityPermission
允许调用非托管代码。 关联的枚举:UnmanagedCode
Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(不支持服务器核心角色), Windows Server 2008 R2(支持带 SP1 或更高版本的服务器核心角色;不支持 Itanium)
.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参阅 .NET Framework 系统要求。