Sdílet prostřednictvím


SerialPort.Write Metoda

Definice

Zapíše data do výstupní vyrovnávací paměti sériového portu.

Přetížení

Write(String)

Zapíše zadaný řetězec na sériový port.

Write(Byte[], Int32, Int32)

Zapíše zadaný počet bajtů na sériový port pomocí dat z vyrovnávací paměti.

Write(Char[], Int32, Int32)

Zapíše zadaný počet znaků na sériový port pomocí dat z vyrovnávací paměti.

Write(String)

Zdroj:
SerialPort.cs
Zdroj:
SerialPort.cs
Zdroj:
SerialPort.cs

Zapíše zadaný řetězec na sériový port.

public:
 void Write(System::String ^ text);
public void Write (string text);
member this.Write : string -> unit
Public Sub Write (text As String)

Parametry

text
String

Řetězec pro výstup.

Výjimky

Zadaný port není otevřený.

text je null.

Operace se nedokončila před vypršením časového limitu.

Poznámky

Tuto metodu použijte, pokud chcete zapsat řetězec jako výstup na sériový port.

Pokud je ve výstupní vyrovnávací paměti příliš mnoho bajtů a Handshake je nastavená na XOnXOff hodnotu , SerialPort může objekt vyvolat během TimeoutException čekání, než bude zařízení připravené přijmout další data.

Ve výchozím nastavení SerialPort používá ASCIIEncoding ke kódování znaků. ASCIIEncoding Zakóduje všechny znaky větší než 127 jako (char)63 nebo ?. Pokud chcete v daném rozsahu podporovat další znaky, nastavte Encoding , UTF8EncodingUTF32Encodingnebo UnicodeEncoding.

Platí pro

Write(Byte[], Int32, Int32)

Zdroj:
SerialPort.cs
Zdroj:
SerialPort.cs
Zdroj:
SerialPort.cs

Zapíše zadaný počet bajtů na sériový port pomocí dat z vyrovnávací paměti.

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)

Parametry

buffer
Byte[]

Pole bajtů obsahující data pro zápis na port.

offset
Int32

Posun bajtů založený na nule v parametru buffer , ve kterém se má začít kopírovat bajty na port.

count
Int32

Počet bajtů, které mají být zapsány.

Výjimky

Předaná buffer hodnota je null.

Zadaný port není otevřený.

Parametry offset nebo count jsou mimo platnou oblast předávaného parametru buffer . Buď offset je, nebo count je menší než nula.

offset plus count je větší než délka buffer.

Operace se nedokončila před vypršením časového limitu.

Poznámky

Tuto metodu použijte, když chcete zapisovat do vyrovnávací paměti bajtů pro vytvoření výstupu na sériový port.

Pokud je ve výstupní vyrovnávací paměti příliš mnoho bajtů a Handshake je nastavená na XOnXOff hodnotu , SerialPort může objekt vyvolat během TimeoutException čekání, než bude zařízení připravené přijmout další data.

Platí pro

Write(Char[], Int32, Int32)

Zdroj:
SerialPort.cs
Zdroj:
SerialPort.cs
Zdroj:
SerialPort.cs

Zapíše zadaný počet znaků na sériový port pomocí dat z vyrovnávací paměti.

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)

Parametry

buffer
Char[]

Pole znaků, které obsahuje data pro zápis na port.

offset
Int32

Posun bajtů založený na nule v parametru buffer , ve kterém se má začít kopírovat bajty na port.

count
Int32

Počet znaků k zápisu.

Výjimky

Předaná buffer hodnota je null.

Zadaný port není otevřený.

Parametry offset nebo count jsou mimo platnou oblast předávaného parametru buffer . Buď offset je, nebo count je menší než nula.

offset plus count je větší než délka buffer.

Operace se nedokončila před vypršením časového limitu.

Poznámky

Tuto metodu použijte, když chcete zapisovat do vyrovnávací paměti znaků pro vytvoření výstupu na sériový port.

Pokud je ve výstupní vyrovnávací paměti příliš mnoho bajtů a Handshake je nastavená na XOnXOff hodnotu , SerialPort může objekt vyvolat během TimeoutException čekání, než bude zařízení připravené přijmout další data.

Ve výchozím nastavení SerialPort používá ASCIIEncoding ke kódování znaků. ASCIIEncoding Zakóduje všechny znaky větší než 127 jako (char)63 nebo ?. Pokud chcete v daném rozsahu podporovat další znaky, nastavte Encoding , UTF8EncodingUTF32Encodingnebo UnicodeEncoding.

Platí pro