SerialPort.Write Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrit des données dans la mémoire tampon de sortie du port série.
Surcharges
| Nom | Description |
|---|---|
| Write(String) |
Écrit la chaîne spécifiée dans le port série. |
| Write(Byte[], Int32, Int32) |
Écrit un nombre spécifié d’octets dans le port série à l’aide de données d’une mémoire tampon. |
| Write(Char[], Int32, Int32) |
Écrit un nombre spécifié de caractères dans le port série à l’aide de données d’une mémoire tampon. |
Write(String)
Écrit la chaîne spécifiée dans le port série.
public:
void Write(System::String ^ text);public void Write(string text);member this.Write : string -> unitPublic 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 n’a pas terminé avant la fin du délai d’attente.
Remarques
Utilisez cette méthode lorsque vous souhaitez écrire une chaîne en tant que sortie dans un port série.
S’il y a trop d’octets dans la mémoire tampon de sortie et Handshake qu’il est défini pour XOnXOff que l’objet SerialPort puisse déclencher un TimeoutException certain temps, 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 en tant que (char)63 ou ' ?'. Pour prendre en charge des caractères supplémentaires dans cette plage, définissez Encoding sur UTF8Encoding, UTF32Encodingou UnicodeEncoding.
S’applique à
Write(Byte[], Int32, Int32)
Écrit un nombre spécifié d’octets dans le port série à l’aide de 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 -> unitPublic Sub Write (buffer As Byte(), offset As Integer, count As Integer)Paramètres
- buffer
- Byte[]
Tableau d’octets qui contient les données à écrire dans le port.
- offset
- Int32
Décalage d’octet de base zéro dans le buffer paramètre auquel commencer la copie d’octets dans le port.
- count
- Int32
Nombre d’octets à écrire.
Exceptions
Le buffer passé est null.
Le port spécifié n’est pas ouvert.
Le ou offset les count paramètres se trouvent en dehors d’une région valide du buffer passage. Soit offset est inférieur à count zéro.
offset plus count est supérieur à la longueur du buffer.
L’opération n’a pas terminé avant la fin du délai d’attente.
Remarques
Utilisez cette méthode lorsque vous souhaitez écrire dans une mémoire tampon d’octets pour créer une sortie dans un port série.
S’il y a trop d’octets dans la mémoire tampon de sortie et Handshake qu’il est défini pour XOnXOff que l’objet SerialPort puisse déclencher un TimeoutException certain temps, il attend que l’appareil soit prêt à accepter davantage de données.
S’applique à
Write(Char[], Int32, Int32)
Écrit un nombre spécifié de caractères dans le port série à l’aide de 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 -> unitPublic 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 dans le port.
- offset
- Int32
Décalage d’octet de base zéro dans le buffer paramètre auquel commencer la copie d’octets dans le port.
- count
- Int32
Nombre de caractères à écrire.
Exceptions
Le buffer passé est null.
Le port spécifié n’est pas ouvert.
Le ou offset les count paramètres se trouvent en dehors d’une région valide du buffer passage. Soit offset est inférieur à count zéro.
offset plus count est supérieur à la longueur du buffer.
L’opération n’a pas terminé 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 dans un port série.
S’il y a trop d’octets dans la mémoire tampon de sortie et Handshake qu’il est défini pour XOnXOff que l’objet SerialPort puisse déclencher un TimeoutException certain temps, 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 en tant que (char)63 ou ' ?'. Pour prendre en charge des caractères supplémentaires dans cette plage, définissez Encoding sur UTF8Encoding, UTF32Encodingou UnicodeEncoding.