SerialPort.Write Metoda

Definicja

Przestrzeń nazw:

System.IO.Ports

Zestaw:

System.IO.Ports.dll

Pakiet:

System.IO.Ports v8.0.0

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

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

InvalidOperationException

Podany port nie jest otwarty.

ArgumentNullException

text to null.

TimeoutException

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.

Write(Byte[], Int32, Int32)

Ź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

ArgumentNullException

Przekazany buffer element to null.

InvalidOperationException

Podany port nie jest otwarty.

ArgumentOutOfRangeException

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

ArgumentException

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

TimeoutException

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.

Write(Char[], Int32, Int32)

Ź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

ArgumentNullException

Przekazany buffer element to null.

InvalidOperationException

Podany port nie jest otwarty.

ArgumentOutOfRangeException

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

ArgumentException

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

TimeoutException

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.