SerialPort.Write Metoda

Definice

Obor názvů:

System.IO.Ports

Sestavení:

System.IO.Ports.dll

Balíček:

System.IO.Ports v8.0.0

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

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

InvalidOperationException

Zadaný port není otevřený.

ArgumentNullException

text je null.

TimeoutException

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.

Write(Byte[], Int32, Int32)

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

ArgumentNullException

Předaná buffer hodnota je null.

InvalidOperationException

Zadaný port není otevřený.

ArgumentOutOfRangeException

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

ArgumentException

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

TimeoutException

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.

Write(Char[], Int32, Int32)

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

ArgumentNullException

Předaná buffer hodnota je null.

InvalidOperationException

Zadaný port není otevřený.

ArgumentOutOfRangeException

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

ArgumentException

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

TimeoutException

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.