Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo SerialPort.Read (Char[], Int32, Int32)

 

Data di pubblicazione: novembre 2016

Legge un numero di caratteri dal buffer di input SerialPort e li scrive in una matrice di caratteri in corrispondenza di un offset specificato.

Spazio dei nomi:   System.IO.Ports
Assembly:  System (in System.dll)

public int Read(
	char[] buffer,
	int offset,
	int count
)

Parametri

buffer
Type: System.Char[]

Matrice di caratteri in cui scrivere l'input.

offset
Type: System.Int32

Offset in buffer in cui scrivere i caratteri.

count
Type: System.Int32

Numero massimo di caratteri da leggere. Se count è maggiore del numero di caratteri nel buffer di input, vengono letti meno caratteri.

Valore restituito

Type: System.Int32

Numero di caratteri letti.

Exception Condition
ArgumentException

offset Oltre a count è maggiore della lunghezza del buffer.

-oppure-

count 1 ed è un carattere surrogato nel buffer.

ArgumentNullException

Il buffer passato è null.

ArgumentOutOfRangeException

Il offset o count i parametri sono di fuori dell'area di validità del buffer passati. Sia offset o count è minore di zero.

InvalidOperationException

La porta specificata non è aperta.

TimeoutException

Caratteri non sono disponibili per la lettura.

Utilizzare questo metodo per la lettura di caratteri dalla porta seriale.

Se è necessario passare dalla lettura di testo e la lettura dei dati binari dal flusso, selezionare un protocollo che definisce il limite tra testo e dati binari, ad esempio la lettura dei byte e decodifica i dati manualmente.

Poiché la SerialPort classe inserisce dati nel buffer e il flusso di contenuto nel BaseStream proprietà non è possibile che una discordanza il numero di caratteri disponibile per la lettura. Il BytesToRead proprietà può indicare che sono presenti caratteri da leggere, ma potrebbe non essere accessibile per il flusso contenuto nella BaseStream proprietà perché sono stati memorizzati per la SerialPort classe.

Il Read metodo non blocca altre operazioni quando il numero di byte letti è uguale a count ma sono disponibili da leggere byte sulla porta seriale.

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: