SerialPort.Write Metod

Definition

Skriver data till utdatabufferten för serieporten.

Överlagringar

Name Description
Write(String)

Skriver den angivna strängen till serieporten.

Write(Byte[], Int32, Int32)

Skriver ett angivet antal byte till serieporten med data från en buffert.

Write(Char[], Int32, Int32)

Skriver ett angivet antal tecken till serieporten med data från en buffert.

Write(String)

Källa:
SerialPort.cs
Källa:
SerialPort.cs
Källa:
SerialPort.cs
Källa:
SerialPort.cs

Skriver den angivna strängen till serieporten.

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

Parametrar

text
String

Strängen för utdata.

Undantag

Den angivna porten är inte öppen.

text är null.

Åtgärden slutfördes inte innan tidsgränsen upphörde.

Kommentarer

Använd den här metoden när du vill skriva en sträng som utdata till en seriell port.

Om det finns för många byte i utdatabufferten och Handshake är inställt på XOnXOff kan SerialPort objektet generera en TimeoutException stund medan det väntar på att enheten ska vara redo att ta emot mer data.

Som standard SerialPort används ASCIIEncoding för att koda tecknen. ASCIIEncoding kodar alla tecken som är större än 127 som (tecken)63 eller '?'. Om du vill ha stöd för ytterligare tecken i intervallet anger du Encoding till UTF8Encoding, UTF32Encodingeller UnicodeEncoding.

Gäller för

Write(Byte[], Int32, Int32)

Källa:
SerialPort.cs
Källa:
SerialPort.cs
Källa:
SerialPort.cs
Källa:
SerialPort.cs

Skriver ett angivet antal byte till serieporten med data från en buffert.

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)

Parametrar

buffer
Byte[]

Byte-matrisen som innehåller de data som ska skrivas till porten.

offset
Int32

Den nollbaserade byteförskjutningen i parametern buffer där byte ska börja kopieras till porten.

count
Int32

Antalet byte som ska skrivas.

Undantag

Den buffer skickade är null.

Den angivna porten är inte öppen.

Parametrarna offset eller count ligger utanför en giltig region för den buffer som skickas. Antingen offset eller count är mindre än noll.

offset plus count är större än längden på buffer.

Åtgärden slutfördes inte innan tidsgränsen upphörde.

Kommentarer

Använd den här metoden när du vill skriva till en bytebuffert för att skapa utdata till en serieport.

Om det finns för många byte i utdatabufferten och Handshake är inställt på XOnXOff kan SerialPort objektet generera en TimeoutException stund medan det väntar på att enheten ska vara redo att ta emot mer data.

Gäller för

Write(Char[], Int32, Int32)

Källa:
SerialPort.cs
Källa:
SerialPort.cs
Källa:
SerialPort.cs
Källa:
SerialPort.cs

Skriver ett angivet antal tecken till serieporten med data från en buffert.

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)

Parametrar

buffer
Char[]

Teckenmatrisen som innehåller de data som ska skrivas till porten.

offset
Int32

Den nollbaserade byteförskjutningen i parametern buffer där byte ska börja kopieras till porten.

count
Int32

Antalet tecken som ska skrivas.

Undantag

Den buffer skickade är null.

Den angivna porten är inte öppen.

Parametrarna offset eller count ligger utanför en giltig region för den buffer som skickas. Antingen offset eller count är mindre än noll.

offset plus count är större än längden på buffer.

Åtgärden slutfördes inte innan tidsgränsen upphörde.

Kommentarer

Använd den här metoden när du vill skriva till en teckenbuffert för att skapa utdata till en seriell port.

Om det finns för många byte i utdatabufferten och Handshake är inställt på XOnXOff kan SerialPort objektet generera en TimeoutException stund medan det väntar på att enheten ska vara redo att ta emot mer data.

Som standard SerialPort används ASCIIEncoding för att koda tecknen. ASCIIEncoding kodar alla tecken som är större än 127 som (tecken)63 eller '?'. Om du vill ha stöd för ytterligare tecken i intervallet anger du Encoding till UTF8Encoding, UTF32Encodingeller UnicodeEncoding.

Gäller för