Udostępnij za pośrednictwem


SerialPort.Write Metoda

Definicja

Zapisuje dane w buforze wyjściowym portu szeregowego.

Przeciążenia

Write(String)

Zapisuje określony ciąg na porcie szeregowym.

Write(Byte[], Int32, Int32)

Zapisuje określoną liczbę bajtów do portu szeregowego przy użyciu danych z buforu.

Write(Char[], Int32, Int32)

Zapisuje określoną liczbę znaków do portu szeregowego przy użyciu danych z buforu.

Write(String)

Źródło:
SerialPort.cs
Źródło:
SerialPort.cs
Źródło:
SerialPort.cs

Zapisuje określony ciąg na porcie szeregowym.

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

Ciąg danych wyjściowych.

Wyjątki

Podany port nie jest otwarty.

text to null.

Operacja nie została ukończona przed upłynięciem limitu czasu.

Uwagi

Użyj tej metody, jeśli chcesz napisać ciąg jako dane wyjściowe do portu szeregowego.

Jeśli w buforze wyjściowym znajduje się zbyt wiele bajtów i Handshake jest ustawionych na XOnXOff wartość , SerialPort obiekt może zgłosić TimeoutException czas oczekiwania na gotowość urządzenia do zaakceptowania większej liczby danych.

Domyślnie SerialPort używa metody ASCIIEncoding do kodowania znaków. ASCIIEncoding koduje wszystkie znaki większe niż 127 jako (char)63 lub "?". Aby obsługiwać dodatkowe znaki w tym zakresie, ustaw wartość EncodingUTF8Encoding, UTF32Encodinglub UnicodeEncoding.

Dotyczy

Write(Byte[], Int32, Int32)

Źródło:
SerialPort.cs
Źródło:
SerialPort.cs
Źródło:
SerialPort.cs

Zapisuje określoną liczbę bajtów do portu szeregowego przy użyciu danych z buforu.

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[]

Tablica bajtów zawierająca dane do zapisu na porcie.

offset
Int32

Przesunięcie bajtu opartego na zera w parametrze buffer , na którym rozpocznie się kopiowanie bajtów do portu.

count
Int32

Liczba bajtów do zapisania.

Wyjątki

Przekazany buffer element to null.

Podany port nie jest otwarty.

Parametry offset or count znajdują się poza prawidłowym regionem przekazywanym buffer . Wartość offset lub count jest mniejsza niż zero.

offset plus count jest większy niż długość obiektu buffer.

Operacja nie została ukończona przed upłynięciem limitu czasu.

Uwagi

Użyj tej metody, jeśli chcesz zapisać w buforze bajtów, aby utworzyć dane wyjściowe na porcie szeregowym.

Jeśli w buforze wyjściowym znajduje się zbyt wiele bajtów i Handshake jest ustawionych na XOnXOff wartość , SerialPort obiekt może zgłosić TimeoutException czas oczekiwania na gotowość urządzenia do zaakceptowania większej liczby danych.

Dotyczy

Write(Char[], Int32, Int32)

Źródło:
SerialPort.cs
Źródło:
SerialPort.cs
Źródło:
SerialPort.cs

Zapisuje określoną liczbę znaków do portu szeregowego przy użyciu danych z buforu.

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[]

Tablica znaków zawierająca dane do zapisu na porcie.

offset
Int32

Przesunięcie bajtu opartego na zera w parametrze buffer , na którym rozpocznie się kopiowanie bajtów do portu.

count
Int32

Liczba znaków, jaka ma zostać zapisana.

Wyjątki

Przekazany buffer element to null.

Podany port nie jest otwarty.

Parametry offset or count znajdują się poza prawidłowym regionem przekazywanym buffer . Wartość offset lub count jest mniejsza niż zero.

offset plus count jest większy niż długość obiektu buffer.

Operacja nie została ukończona przed upłynięciem limitu czasu.

Uwagi

Użyj tej metody, jeśli chcesz zapisać w buforze znaków, aby utworzyć dane wyjściowe na porcie szeregowym.

Jeśli w buforze wyjściowym znajduje się zbyt wiele bajtów i Handshake jest ustawionych na XOnXOff wartość , SerialPort obiekt może zgłosić TimeoutException czas oczekiwania na gotowość urządzenia do zaakceptowania większej liczby danych.

Domyślnie SerialPort używa metody ASCIIEncoding do kodowania znaków. ASCIIEncoding koduje wszystkie znaki większe niż 127 jako (char)63 lub "?". Aby obsługiwać dodatkowe znaki w tym zakresie, ustaw wartość EncodingUTF8Encoding, UTF32Encodinglub UnicodeEncoding.

Dotyczy