Partager via


SerialPort.Write Méthode

Définition

É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
Source:
SerialPort.cs
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

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

text a la valeur null.

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.

S’applique à

Write(Byte[], Int32, Int32)

Source:
SerialPort.cs
Source:
SerialPort.cs
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

Le buffer passé a la valeur null.

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

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.

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

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.

S’applique à

Write(Char[], Int32, Int32)

Source:
SerialPort.cs
Source:
SerialPort.cs
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

Le buffer passé a la valeur null.

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

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.

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

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.

S’applique à