-
Notifications
You must be signed in to change notification settings - Fork 0
/
System.IO.Ports.xml
540 lines (540 loc) · 46.3 KB
/
System.IO.Ports.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
<?xml version="1.0" encoding="utf-8"?>
<doc>
<assembly>
<name>System.IO.Ports</name>
</assembly>
<members>
<member name="T:System.IO.Ports.Handshake">
<summary>Specifies the control protocol used in establishing a serial port communication for a <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="F:System.IO.Ports.Handshake.None">
<summary>No control is used for the handshake.</summary>
</member>
<member name="F:System.IO.Ports.Handshake.RequestToSend">
<summary>Request-to-Send (RTS) hardware flow control is used. RTS signals that data is available for transmission. If the input buffer becomes full, the RTS line will be set to <see langword="false" />. The RTS line will be set to <see langword="true" /> when more room becomes available in the input buffer.</summary>
</member>
<member name="F:System.IO.Ports.Handshake.RequestToSendXOnXOff">
<summary>Both the Request-to-Send (RTS) hardware control and the XON/XOFF software controls are used.</summary>
</member>
<member name="F:System.IO.Ports.Handshake.XOnXOff">
<summary>The XON/XOFF software control protocol is used. The XOFF control is sent to stop the transmission of data. The XON control is sent to resume the transmission. These software controls are used instead of Request to Send (RTS) and Clear to Send (CTS) hardware controls.</summary>
</member>
<member name="T:System.IO.Ports.Parity">
<summary>Specifies the parity bit for a <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="F:System.IO.Ports.Parity.Even">
<summary>Sets the parity bit so that the count of bits set is an even number.</summary>
</member>
<member name="F:System.IO.Ports.Parity.Mark">
<summary>Leaves the parity bit set to 1.</summary>
</member>
<member name="F:System.IO.Ports.Parity.None">
<summary>No parity check occurs.</summary>
</member>
<member name="F:System.IO.Ports.Parity.Odd">
<summary>Sets the parity bit so that the count of bits set is an odd number.</summary>
</member>
<member name="F:System.IO.Ports.Parity.Space">
<summary>Leaves the parity bit set to 0.</summary>
</member>
<member name="T:System.IO.Ports.SerialData">
<summary>Specifies the type of character that was received on the serial port of the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="F:System.IO.Ports.SerialData.Chars">
<summary>A character was received and placed in the input buffer.</summary>
</member>
<member name="F:System.IO.Ports.SerialData.Eof">
<summary>The end of file character was received and placed in the input buffer.</summary>
</member>
<member name="T:System.IO.Ports.SerialDataReceivedEventArgs">
<summary>Provides data for the <see cref="E:System.IO.Ports.SerialPort.DataReceived" /> event.</summary>
</member>
<member name="P:System.IO.Ports.SerialDataReceivedEventArgs.EventType">
<summary>Gets or sets the event type.</summary>
<returns>One of the <see cref="T:System.IO.Ports.SerialData" /> values.</returns>
</member>
<member name="T:System.IO.Ports.SerialDataReceivedEventHandler">
<summary>Represents the method that will handle the <see cref="E:System.IO.Ports.SerialPort.DataReceived" /> event of a <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
<param name="sender">The sender of the event, which is the <see cref="T:System.IO.Ports.SerialPort" /> object.</param>
<param name="e">A <see cref="T:System.IO.Ports.SerialDataReceivedEventArgs" /> object that contains the event data.</param>
</member>
<member name="T:System.IO.Ports.SerialError">
<summary>Specifies errors that occur on the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="F:System.IO.Ports.SerialError.Frame">
<summary>The hardware detected a framing error.</summary>
</member>
<member name="F:System.IO.Ports.SerialError.Overrun">
<summary>A character-buffer overrun has occurred. The next character is lost.</summary>
</member>
<member name="F:System.IO.Ports.SerialError.RXOver">
<summary>An input buffer overflow has occurred. There is either no room in the input buffer, or a character was received after the end-of-file (EOF) character.</summary>
</member>
<member name="F:System.IO.Ports.SerialError.RXParity">
<summary>The hardware detected a parity error.</summary>
</member>
<member name="F:System.IO.Ports.SerialError.TXFull">
<summary>The application tried to transmit a character, but the output buffer was full.</summary>
</member>
<member name="T:System.IO.Ports.SerialErrorReceivedEventArgs">
<summary>Prepares data for the <see cref="E:System.IO.Ports.SerialPort.ErrorReceived" /> event.</summary>
</member>
<member name="P:System.IO.Ports.SerialErrorReceivedEventArgs.EventType">
<summary>Gets or sets the event type.</summary>
<returns>One of the <see cref="T:System.IO.Ports.SerialError" /> values.</returns>
</member>
<member name="T:System.IO.Ports.SerialErrorReceivedEventHandler">
<summary>Represents the method that will handle the <see cref="E:System.IO.Ports.SerialPort.ErrorReceived" /> event of a <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
<param name="sender">The sender of the event, which is the <see cref="T:System.IO.Ports.SerialPort" /> object.</param>
<param name="e">A <see cref="T:System.IO.Ports.SerialErrorReceivedEventArgs" /> object that contains the event data.</param>
</member>
<member name="T:System.IO.Ports.SerialPinChange">
<summary>Specifies the type of change that occurred on the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="F:System.IO.Ports.SerialPinChange.Break">
<summary>A break was detected on input.</summary>
</member>
<member name="F:System.IO.Ports.SerialPinChange.CDChanged">
<summary>The Carrier Detect (CD) signal changed state. This signal is used to indicate whether a modem is connected to a working phone line and a data carrier signal is detected.</summary>
</member>
<member name="F:System.IO.Ports.SerialPinChange.CtsChanged">
<summary>The Clear to Send (CTS) signal changed state. This signal is used to indicate whether data can be sent over the serial port.</summary>
</member>
<member name="F:System.IO.Ports.SerialPinChange.DsrChanged">
<summary>The Data Set Ready (DSR) signal changed state. This signal is used to indicate whether the device on the serial port is ready to operate.</summary>
</member>
<member name="F:System.IO.Ports.SerialPinChange.Ring">
<summary>A ring indicator was detected.</summary>
</member>
<member name="T:System.IO.Ports.SerialPinChangedEventArgs">
<summary>Provides data for the <see cref="E:System.IO.Ports.SerialPort.PinChanged" /> event.</summary>
</member>
<member name="P:System.IO.Ports.SerialPinChangedEventArgs.EventType">
<summary>Gets or sets the event type.</summary>
<returns>One of the <see cref="T:System.IO.Ports.SerialPinChange" /> values.</returns>
</member>
<member name="T:System.IO.Ports.SerialPinChangedEventHandler">
<summary>Represents the method that will handle the <see cref="E:System.IO.Ports.SerialPort.PinChanged" /> event of a <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
<param name="sender">The source of the event, which is the <see cref="T:System.IO.Ports.SerialPort" /> object.</param>
<param name="e">A <see cref="T:System.IO.Ports.SerialPinChangedEventArgs" /> object that contains the event data.</param>
</member>
<member name="T:System.IO.Ports.SerialPort">
<summary>Represents a serial port resource.</summary>
</member>
<member name="M:System.IO.Ports.SerialPort.#ctor">
<summary>Initializes a new instance of the <see cref="T:System.IO.Ports.SerialPort" /> class.</summary>
</member>
<member name="M:System.IO.Ports.SerialPort.#ctor(System.ComponentModel.IContainer)">
<summary>Initializes a new instance of the <see cref="T:System.IO.Ports.SerialPort" /> class using the specified <see cref="T:System.ComponentModel.IContainer" /> object.</summary>
<param name="container">An interface to a container.</param>
<exception cref="T:System.IO.IOException">The specified port could not be found or opened.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.#ctor(System.String)">
<summary>Initializes a new instance of the <see cref="T:System.IO.Ports.SerialPort" /> class using the specified port name.</summary>
<param name="portName">The port to use (for example, COM1).</param>
<exception cref="T:System.IO.IOException">The specified port could not be found or opened.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.#ctor(System.String,System.Int32)">
<summary>Initializes a new instance of the <see cref="T:System.IO.Ports.SerialPort" /> class using the specified port name and baud rate.</summary>
<param name="portName">The port to use (for example, COM1).</param>
<param name="baudRate">The baud rate.</param>
<exception cref="T:System.IO.IOException">The specified port could not be found or opened.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.#ctor(System.String,System.Int32,System.IO.Ports.Parity)">
<summary>Initializes a new instance of the <see cref="T:System.IO.Ports.SerialPort" /> class using the specified port name, baud rate, and parity bit.</summary>
<param name="portName">The port to use (for example, COM1).</param>
<param name="baudRate">The baud rate.</param>
<param name="parity">One of the <see cref="P:System.IO.Ports.SerialPort.Parity" /> values.</param>
<exception cref="T:System.IO.IOException">The specified port could not be found or opened.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.#ctor(System.String,System.Int32,System.IO.Ports.Parity,System.Int32)">
<summary>Initializes a new instance of the <see cref="T:System.IO.Ports.SerialPort" /> class using the specified port name, baud rate, parity bit, and data bits.</summary>
<param name="portName">The port to use (for example, COM1).</param>
<param name="baudRate">The baud rate.</param>
<param name="parity">One of the <see cref="P:System.IO.Ports.SerialPort.Parity" /> values.</param>
<param name="dataBits">The data bits value.</param>
<exception cref="T:System.IO.IOException">The specified port could not be found or opened.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.#ctor(System.String,System.Int32,System.IO.Ports.Parity,System.Int32,System.IO.Ports.StopBits)">
<summary>Initializes a new instance of the <see cref="T:System.IO.Ports.SerialPort" /> class using the specified port name, baud rate, parity bit, data bits, and stop bit.</summary>
<param name="portName">The port to use (for example, COM1).</param>
<param name="baudRate">The baud rate.</param>
<param name="parity">One of the <see cref="P:System.IO.Ports.SerialPort.Parity" /> values.</param>
<param name="dataBits">The data bits value.</param>
<param name="stopBits">One of the <see cref="P:System.IO.Ports.SerialPort.StopBits" /> values.</param>
<exception cref="T:System.IO.IOException">The specified port could not be found or opened.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.BaseStream">
<summary>Gets the underlying <see cref="T:System.IO.Stream" /> object for a <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
<returns>A <see cref="T:System.IO.Stream" /> object.</returns>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
<exception cref="T:System.NotSupportedException">The stream is in a .NET Compact Framework application and one of the following methods was called:
<see cref="M:System.IO.Stream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /><see cref="M:System.IO.Stream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /><see cref="M:System.IO.Stream.EndRead(System.IAsyncResult)" /><see cref="M:System.IO.Stream.EndWrite(System.IAsyncResult)" />
The .NET Compact Framework does not support the asynchronous model with base streams.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.BaudRate">
<summary>Gets or sets the serial baud rate.</summary>
<returns>The baud rate.</returns>
<exception cref="T:System.ArgumentOutOfRangeException">The baud rate specified is less than or equal to zero, or is greater than the maximum allowable baud rate for the device.</exception>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.BreakState">
<summary>Gets or sets the break signal state.</summary>
<returns>
<see langword="true" /> if the port is in a break state; otherwise, <see langword="false" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.BytesToRead">
<summary>Gets the number of bytes of data in the receive buffer.</summary>
<returns>The number of bytes of data in the receive buffer.</returns>
<exception cref="T:System.InvalidOperationException">The port is not open.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.BytesToWrite">
<summary>Gets the number of bytes of data in the send buffer.</summary>
<returns>The number of bytes of data in the send buffer.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.CDHolding">
<summary>Gets the state of the Carrier Detect line for the port.</summary>
<returns>
<see langword="true" /> if the carrier is detected; otherwise, <see langword="false" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Close">
<summary>Closes the port connection, sets the <see cref="P:System.IO.Ports.SerialPort.IsOpen" /> property to <see langword="false" />, and disposes of the internal <see cref="T:System.IO.Stream" /> object.</summary>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.CtsHolding">
<summary>Gets the state of the Clear-to-Send line.</summary>
<returns>
<see langword="true" /> if the Clear-to-Send line is detected; otherwise, <see langword="false" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.DataBits">
<summary>Gets or sets the standard length of data bits per byte.</summary>
<returns>The data bits length.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The data bits value is less than 5 or more than 8.</exception>
</member>
<member name="E:System.IO.Ports.SerialPort.DataReceived">
<summary>Indicates that data has been received through a port represented by the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="M:System.IO.Ports.SerialPort.DiscardInBuffer">
<summary>Discards data from the serial driver's receive buffer.</summary>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.DiscardNull">
<summary>Gets or sets a value indicating whether null bytes are ignored when transmitted between the port and the receive buffer.</summary>
<returns>
<see langword="true" /> if null bytes are ignored; otherwise <see langword="false" />. The default is <see langword="false" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.DiscardOutBuffer">
<summary>Discards data from the serial driver's transmit buffer.</summary>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Dispose(System.Boolean)">
<summary>Releases the unmanaged resources used by the <see cref="T:System.IO.Ports.SerialPort" /> and optionally releases the managed resources.</summary>
<param name="disposing">
<see langword="true" /> to release both managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.DsrHolding">
<summary>Gets the state of the Data Set Ready (DSR) signal.</summary>
<returns>
<see langword="true" /> if a Data Set Ready signal has been sent to the port; otherwise, <see langword="false" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The stream is closed. This can occur because the <see cref="M:System.IO.Ports.SerialPort.Open" /> method has not been called or the <see cref="M:System.IO.Ports.SerialPort.Close" /> method has been called.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.DtrEnable">
<summary>Gets or sets a value that enables the Data Terminal Ready (DTR) signal during serial communication.</summary>
<returns>
<see langword="true" /> to enable Data Terminal Ready (DTR); otherwise, <see langword="false" />. The default is <see langword="false" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.Encoding">
<summary>Gets or sets the byte encoding for pre- and post-transmission conversion of text.</summary>
<returns>An <see cref="T:System.Text.Encoding" /> object. The default is <see cref="T:System.Text.ASCIIEncoding" />.</returns>
<exception cref="T:System.ArgumentNullException">The <see cref="P:System.IO.Ports.SerialPort.Encoding" /> property was set to <see langword="null" />.</exception>
<exception cref="T:System.ArgumentException">The <see cref="P:System.IO.Ports.SerialPort.Encoding" /> property was set to an encoding that is not <see cref="T:System.Text.ASCIIEncoding" />, <see cref="T:System.Text.UTF8Encoding" />, <see cref="T:System.Text.UTF32Encoding" />, <see cref="T:System.Text.UnicodeEncoding" />, one of the Windows single byte encodings, or one of the Windows double byte encodings.</exception>
</member>
<member name="E:System.IO.Ports.SerialPort.ErrorReceived">
<summary>Indicates that an error has occurred with a port represented by a <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="M:System.IO.Ports.SerialPort.GetPortNames">
<summary>Gets an array of serial port names for the current computer.</summary>
<returns>An array of serial port names for the current computer.</returns>
<exception cref="T:System.ComponentModel.Win32Exception">The serial port names could not be queried.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.Handshake">
<summary>Gets or sets the handshaking protocol for serial port transmission of data using a value from <see cref="T:System.IO.Ports.Handshake" />.</summary>
<returns>One of the <see cref="T:System.IO.Ports.Handshake" /> values. The default is <see langword="None" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The value passed is not a valid value in the <see cref="T:System.IO.Ports.Handshake" /> enumeration.</exception>
</member>
<member name="F:System.IO.Ports.SerialPort.InfiniteTimeout">
<summary>Indicates that no time-out should occur.</summary>
</member>
<member name="P:System.IO.Ports.SerialPort.IsOpen">
<summary>Gets a value indicating the open or closed status of the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
<returns>
<see langword="true" /> if the serial port is open; otherwise, <see langword="false" />. The default is <see langword="false" />.</returns>
<exception cref="T:System.ArgumentNullException">The <see cref="P:System.IO.Ports.SerialPort.IsOpen" /> value passed is <see langword="null" />.</exception>
<exception cref="T:System.ArgumentException">The <see cref="P:System.IO.Ports.SerialPort.IsOpen" /> value passed is an empty string ("").</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.NewLine">
<summary>Gets or sets the value used to interpret the end of a call to the <see cref="M:System.IO.Ports.SerialPort.ReadLine" /> and <see cref="M:System.IO.Ports.SerialPort.WriteLine(System.String)" /> methods.</summary>
<returns>A value that represents the end of a line. The default is a line feed ("\n" in C# or <see cref="F:Microsoft.VisualBasic.Constants.vbLf" /> in Visual Basic).</returns>
<exception cref="T:System.ArgumentException">The property value is empty.</exception>
<exception cref="T:System.ArgumentNullException">The property value is <see langword="null" />.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Open">
<summary>Opens a new serial port connection.</summary>
<exception cref="T:System.UnauthorizedAccessException">Access is denied to the port.
-or-
The current process, or another process on the system, already has the specified COM port open either by a <see cref="T:System.IO.Ports.SerialPort" /> instance or in unmanaged code.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">One or more of the properties for this instance are invalid. For example, the <see cref="P:System.IO.Ports.SerialPort.Parity" />, <see cref="P:System.IO.Ports.SerialPort.DataBits" />, or <see cref="P:System.IO.Ports.SerialPort.Handshake" /> properties are not valid values; the <see cref="P:System.IO.Ports.SerialPort.BaudRate" /> is less than or equal to zero; the <see cref="P:System.IO.Ports.SerialPort.ReadTimeout" /> or <see cref="P:System.IO.Ports.SerialPort.WriteTimeout" /> property is less than zero and is not <see cref="F:System.IO.Ports.SerialPort.InfiniteTimeout" />.</exception>
<exception cref="T:System.ArgumentException">The port name does not begin with "COM".
-or-
The file type of the port is not supported.</exception>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.InvalidOperationException">The specified port on the current instance of the <see cref="T:System.IO.Ports.SerialPort" /> is already open.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.Parity">
<summary>Gets or sets the parity-checking protocol.</summary>
<returns>One of the enumeration values that represents the parity-checking protocol. The default is <see cref="F:System.IO.Ports.Parity.None" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The <see cref="P:System.IO.Ports.SerialPort.Parity" /> value passed is not a valid value in the <see cref="T:System.IO.Ports.Parity" /> enumeration.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.ParityReplace">
<summary>Gets or sets the byte that replaces invalid bytes in a data stream when a parity error occurs.</summary>
<returns>A byte that replaces invalid bytes.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
</member>
<member name="E:System.IO.Ports.SerialPort.PinChanged">
<summary>Indicates that a non-data signal event has occurred on the port represented by the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="P:System.IO.Ports.SerialPort.PortName">
<summary>Gets or sets the port for communications, including but not limited to all available COM ports.</summary>
<returns>The communications port. The default is COM1.</returns>
<exception cref="T:System.ArgumentException">The <see cref="P:System.IO.Ports.SerialPort.PortName" /> property was set to a value with a length of zero.
-or-
The <see cref="P:System.IO.Ports.SerialPort.PortName" /> property was set to a value that starts with "\\".
-or-
The port name was not valid.</exception>
<exception cref="T:System.ArgumentNullException">The <see cref="P:System.IO.Ports.SerialPort.PortName" /> property was set to <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">The specified port is open.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Read(System.Byte[],System.Int32,System.Int32)">
<summary>Reads a number of bytes from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer and writes those bytes into a byte array at the specified offset.</summary>
<param name="buffer">The byte array to write the input to.</param>
<param name="offset">The offset in <paramref name="buffer" /> at which to write the bytes.</param>
<param name="count">The maximum number of bytes to read. Fewer bytes are read if <paramref name="count" /> is greater than the number of bytes in the input buffer.</param>
<returns>The number of bytes read.</returns>
<exception cref="T:System.ArgumentNullException">The buffer passed is <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="offset" /> or <paramref name="count" /> parameters are outside a valid region of the <paramref name="buffer" /> being passed. Either <paramref name="offset" /> or <paramref name="count" /> is less than zero.</exception>
<exception cref="T:System.ArgumentException">
<paramref name="offset" /> plus <paramref name="count" /> is greater than the length of the <paramref name="buffer" />.</exception>
<exception cref="T:System.TimeoutException">No bytes were available to read.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Read(System.Char[],System.Int32,System.Int32)">
<summary>Reads a number of characters from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer and writes them into an array of characters at a given offset.</summary>
<param name="buffer">The character array to write the input to.</param>
<param name="offset">The offset in <paramref name="buffer" /> at which to write the characters.</param>
<param name="count">The maximum number of characters to read. Fewer characters are read if <paramref name="count" /> is greater than the number of characters in the input buffer.</param>
<returns>The number of characters read.</returns>
<exception cref="T:System.ArgumentException">
<paramref name="offset" /> plus <paramref name="count" /> is greater than the length of the buffer.
-or-
<paramref name="count" /> is 1 and there is a surrogate character in the buffer.</exception>
<exception cref="T:System.ArgumentNullException">The <paramref name="buffer" /> passed is <see langword="null" />.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="offset" /> or <paramref name="count" /> parameters are outside a valid region of the <paramref name="buffer" /> being passed. Either <paramref name="offset" /> or <paramref name="count" /> is less than zero.</exception>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.TimeoutException">No characters were available to read.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.ReadBufferSize">
<summary>Gets or sets the size of the <see cref="T:System.IO.Ports.SerialPort" /> input buffer.</summary>
<returns>The buffer size, in bytes. The default value is 4096; the maximum value is that of a positive int, or 2147483647.</returns>
<exception cref="T:System.ArgumentOutOfRangeException">The <see cref="P:System.IO.Ports.SerialPort.ReadBufferSize" /> value set is less than or equal to zero.</exception>
<exception cref="T:System.InvalidOperationException">The <see cref="P:System.IO.Ports.SerialPort.ReadBufferSize" /> property was set while the stream was open.</exception>
<exception cref="T:System.IO.IOException">The <see cref="P:System.IO.Ports.SerialPort.ReadBufferSize" /> property was set to an odd integer value.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.ReadByte">
<summary>Synchronously reads one byte from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer.</summary>
<returns>The byte, cast to an <see cref="T:System.Int32" />, or -1 if the end of the stream has been read.</returns>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.ServiceProcess.TimeoutException">The operation did not complete before the time-out period ended.
-or-
No byte was read.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.ReadChar">
<summary>Synchronously reads one character from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer.</summary>
<returns>The character that was read.</returns>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.ServiceProcess.TimeoutException">The operation did not complete before the time-out period ended.
-or-
No character was available in the allotted time-out period.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.ReadExisting">
<summary>Reads all immediately available bytes, based on the encoding, in both the stream and the input buffer of the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
<returns>The contents of the stream and the input buffer of the <see cref="T:System.IO.Ports.SerialPort" /> object.</returns>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.ReadLine">
<summary>Reads up to the <see cref="P:System.IO.Ports.SerialPort.NewLine" /> value in the input buffer.</summary>
<returns>The contents of the input buffer up to the first occurrence of a <see cref="P:System.IO.Ports.SerialPort.NewLine" /> value.</returns>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.TimeoutException">The operation did not complete before the time-out period ended.
-or-
No bytes were read.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.ReadTimeout">
<summary>Gets or sets the number of milliseconds before a time-out occurs when a read operation does not finish.</summary>
<returns>The number of milliseconds before a time-out occurs when a read operation does not finish.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The read time-out value is less than zero and not equal to <see cref="F:System.IO.Ports.SerialPort.InfiniteTimeout" />.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.ReadTo(System.String)">
<summary>Reads a string up to the specified <paramref name="value" /> in the input buffer.</summary>
<param name="value">A value that indicates where the read operation stops.</param>
<returns>The contents of the input buffer up to the specified <paramref name="value" />.</returns>
<exception cref="T:System.ArgumentException">The length of the <paramref name="value" /> parameter is 0.</exception>
<exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.TimeoutException">The operation did not complete before the time-out period ended.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.ReceivedBytesThreshold">
<summary>Gets or sets the number of bytes in the internal input buffer before a <see cref="E:System.IO.Ports.SerialPort.DataReceived" /> event occurs.</summary>
<returns>The number of bytes in the internal input buffer before a <see cref="E:System.IO.Ports.SerialPort.DataReceived" /> event is fired. The default is 1.</returns>
<exception cref="T:System.ArgumentOutOfRangeException">The <see cref="P:System.IO.Ports.SerialPort.ReceivedBytesThreshold" /> value is less than or equal to zero.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.RtsEnable">
<summary>Gets or sets a value indicating whether the Request to Send (RTS) signal is enabled during serial communication.</summary>
<returns>
<see langword="true" /> to enable Request to Transmit (RTS); otherwise, <see langword="false" />. The default is <see langword="false" />.</returns>
<exception cref="T:System.InvalidOperationException">The value of the <see cref="P:System.IO.Ports.SerialPort.RtsEnable" /> property was set or retrieved while the <see cref="P:System.IO.Ports.SerialPort.Handshake" /> property is set to the <see cref="F:System.IO.Ports.Handshake.RequestToSend" /> value or the <see cref="F:System.IO.Ports.Handshake.RequestToSendXOnXOff" /> value.</exception>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.StopBits">
<summary>Gets or sets the standard number of stopbits per byte.</summary>
<returns>One of the <see cref="T:System.IO.Ports.StopBits" /> values.</returns>
<exception cref="T:System.ArgumentOutOfRangeException">The <see cref="P:System.IO.Ports.SerialPort.StopBits" /> value is <see cref="F:System.IO.Ports.StopBits.None" />.</exception>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Write(System.Byte[],System.Int32,System.Int32)">
<summary>Writes a specified number of bytes to the serial port using data from a buffer.</summary>
<param name="buffer">The byte array that contains the data to write to the port.</param>
<param name="offset">The zero-based byte offset in the <paramref name="buffer" /> parameter at which to begin copying bytes to the port.</param>
<param name="count">The number of bytes to write.</param>
<exception cref="T:System.ArgumentNullException">The <paramref name="buffer" /> passed is <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="offset" /> or <paramref name="count" /> parameters are outside a valid region of the <paramref name="buffer" /> being passed. Either <paramref name="offset" /> or <paramref name="count" /> is less than zero.</exception>
<exception cref="T:System.ArgumentException">
<paramref name="offset" /> plus <paramref name="count" /> is greater than the length of the <paramref name="buffer" />.</exception>
<exception cref="T:System.ServiceProcess.TimeoutException">The operation did not complete before the time-out period ended.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Write(System.Char[],System.Int32,System.Int32)">
<summary>Writes a specified number of characters to the serial port using data from a buffer.</summary>
<param name="buffer">The character array that contains the data to write to the port.</param>
<param name="offset">The zero-based byte offset in the <paramref name="buffer" /> parameter at which to begin copying bytes to the port.</param>
<param name="count">The number of characters to write.</param>
<exception cref="T:System.ArgumentNullException">The <paramref name="buffer" /> passed is <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="offset" /> or <paramref name="count" /> parameters are outside a valid region of the <paramref name="buffer" /> being passed. Either <paramref name="offset" /> or <paramref name="count" /> is less than zero.</exception>
<exception cref="T:System.ArgumentException">
<paramref name="offset" /> plus <paramref name="count" /> is greater than the length of the <paramref name="buffer" />.</exception>
<exception cref="T:System.ServiceProcess.TimeoutException">The operation did not complete before the time-out period ended.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.Write(System.String)">
<summary>Writes the specified string to the serial port.</summary>
<param name="text">The string for output.</param>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.ArgumentNullException">
<paramref name="text" /> is <see langword="null" />.</exception>
<exception cref="T:System.ServiceProcess.TimeoutException">The operation did not complete before the time-out period ended.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.WriteBufferSize">
<summary>Gets or sets the size of the serial port output buffer.</summary>
<returns>The size of the output buffer. The default is 2048.</returns>
<exception cref="T:System.ArgumentOutOfRangeException">The <see cref="P:System.IO.Ports.SerialPort.WriteBufferSize" /> value is less than or equal to zero.</exception>
<exception cref="T:System.InvalidOperationException">The <see cref="P:System.IO.Ports.SerialPort.WriteBufferSize" /> property was set while the stream was open.</exception>
<exception cref="T:System.IO.IOException">The <see cref="P:System.IO.Ports.SerialPort.WriteBufferSize" /> property was set to an odd integer value.</exception>
</member>
<member name="M:System.IO.Ports.SerialPort.WriteLine(System.String)">
<summary>Writes the specified string and the <see cref="P:System.IO.Ports.SerialPort.NewLine" /> value to the output buffer.</summary>
<param name="text">The string to write to the output buffer.</param>
<exception cref="T:System.ArgumentNullException">The <paramref name="text" /> parameter is <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">The specified port is not open.</exception>
<exception cref="T:System.TimeoutException">The <see cref="M:System.IO.Ports.SerialPort.WriteLine(System.String)" /> method could not write to the stream.</exception>
</member>
<member name="P:System.IO.Ports.SerialPort.WriteTimeout">
<summary>Gets or sets the number of milliseconds before a time-out occurs when a write operation does not finish.</summary>
<returns>The number of milliseconds before a time-out occurs. The default is <see cref="F:System.IO.Ports.SerialPort.InfiniteTimeout" />.</returns>
<exception cref="T:System.IO.IOException">The port is in an invalid state.
-or-
An attempt to set the state of the underlying port failed. For example, the parameters passed from this <see cref="T:System.IO.Ports.SerialPort" /> object were invalid.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">The <see cref="P:System.IO.Ports.SerialPort.WriteTimeout" /> value is less than zero and not equal to <see cref="F:System.IO.Ports.SerialPort.InfiniteTimeout" />.</exception>
</member>
<member name="T:System.IO.Ports.StopBits">
<summary>Specifies the number of stop bits used on the <see cref="T:System.IO.Ports.SerialPort" /> object.</summary>
</member>
<member name="F:System.IO.Ports.StopBits.None">
<summary>No stop bits are used. This value is not supported by the <see cref="P:System.IO.Ports.SerialPort.StopBits" /> property.</summary>
</member>
<member name="F:System.IO.Ports.StopBits.One">
<summary>One stop bit is used.</summary>
</member>
<member name="F:System.IO.Ports.StopBits.OnePointFive">
<summary>1.5 stop bits are used.</summary>
</member>
<member name="F:System.IO.Ports.StopBits.Two">
<summary>Two stop bits are used.</summary>
</member>
</members>
</doc>