SerialPort.Write Méthode

Définition

Espace de noms:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Paquet:

System.IO.Ports v8.0.0

Écrit les données dans la mémoire tampon de sortie du port série.

Surcharges

Write(String)	Écrit la chaîne spécifiée sur le port série.
Write(Byte[], Int32, Int32)	Écrit un nombre spécifié d'octets sur le port série en utilisant les données d'une mémoire tampon.
Write(Char[], Int32, Int32)	Écrit un nombre spécifié de caractères sur le port série en utilisant les données d'une mémoire tampon.

Write(String)

Source:

SerialPort.cs

Écrit la chaîne spécifiée sur le port série.

public:
 void Write(System::String ^ text);

public void Write (string text);

member this.Write : string -> unit

Public Sub Write (text As String)

Paramètres

text

String

Chaîne de sortie.

Exceptions

InvalidOperationException

Le port spécifié n'est pas ouvert.

ArgumentNullException

text a la valeur null.

TimeoutException

L'opération ne s'est pas terminée avant la fin du délai d'attente.

Remarques

Utilisez cette méthode lorsque vous souhaitez écrire une chaîne en tant que sortie sur un port série.

S’il y a trop d’octets dans la mémoire tampon de sortie et Handshake que est défini sur XOnXOff , l’objet SerialPort peut déclencher un TimeoutException pendant qu’il attend que l’appareil soit prêt à accepter davantage de données.

Par défaut, SerialPort utilise ASCIIEncoding pour encoder les caractères. ASCIIEncoding encode tous les caractères supérieurs à 127 sous la forme (char)63 ou « ? ». Pour prendre en charge des caractères supplémentaires dans cette plage, définissez sur EncodingUTF8Encoding, UTF32Encodingou UnicodeEncoding.

Write(Byte[], Int32, Int32)

Source:

SerialPort.cs

Écrit un nombre spécifié d'octets sur le port série en utilisant les données d'une mémoire tampon.

public:
 void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public void Write (byte[] buffer, int offset, int count);

member this.Write : byte[] * int * int -> unit

Public Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Paramètres

buffer

Byte[]

Tableau d'octets qui contient les données à écrire sur le port.

offset

Int32

Dans le paramètre buffer, décalage d'octet de base zéro auquel commencer la copie des octets vers le port.

count

Int32

Nombre d'octets à écrire.

Exceptions

ArgumentNullException

Le buffer passé a la valeur null.

InvalidOperationException

Le port spécifié n'est pas ouvert.

ArgumentOutOfRangeException

Les paramètres offset ou count sont à l'extérieur d'une région valide du buffer qui est passé. offset ou count est inférieur à zéro.

ArgumentException

offset plus count est supérieur à la longueur de buffer.

TimeoutException

L'opération ne s'est pas terminée avant la fin du délai d'attente.

Remarques

Utilisez cette méthode lorsque vous souhaitez écrire dans une mémoire tampon d’octets afin de créer une sortie sur un port série.

S’il y a trop d’octets dans la mémoire tampon de sortie et Handshake que est défini sur XOnXOff , l’objet SerialPort peut déclencher un TimeoutException pendant qu’il attend que l’appareil soit prêt à accepter davantage de données.

Write(Char[], Int32, Int32)

Source:

SerialPort.cs

Écrit un nombre spécifié de caractères sur le port série en utilisant les données d'une mémoire tampon.

public:
 void Write(cli::array <char> ^ buffer, int offset, int count);

public void Write (char[] buffer, int offset, int count);

member this.Write : char[] * int * int -> unit

Public Sub Write (buffer As Char(), offset As Integer, count As Integer)

Paramètres

buffer

Char[]

Tableau de caractères qui contient les données à écrire sur le port.

offset

Int32

Dans le paramètre buffer, décalage d'octet de base zéro auquel commencer la copie des octets vers le port.

count

Int32

Nombre de caractères à écrire.

Exceptions

ArgumentNullException

Le buffer passé a la valeur null.

InvalidOperationException

Le port spécifié n'est pas ouvert.

ArgumentOutOfRangeException

Les paramètres offset ou count sont à l'extérieur d'une région valide du buffer qui est passé. offset ou count est inférieur à zéro.

ArgumentException

offset plus count est supérieur à la longueur de buffer.

TimeoutException

L'opération ne s'est pas terminée avant la fin du délai d'attente.

Remarques

Utilisez cette méthode lorsque vous souhaitez écrire dans une mémoire tampon de caractères pour créer une sortie sur un port série.

S’il y a trop d’octets dans la mémoire tampon de sortie et Handshake que est défini sur XOnXOff , l’objet SerialPort peut déclencher un TimeoutException pendant qu’il attend que l’appareil soit prêt à accepter davantage de données.

Par défaut, SerialPort utilise ASCIIEncoding pour encoder les caractères. ASCIIEncoding encode tous les caractères supérieurs à 127 sous la forme (char)63 ou « ? ». Pour prendre en charge des caractères supplémentaires dans cette plage, définissez sur EncodingUTF8Encoding, UTF32Encodingou UnicodeEncoding.