SerialPort.Write Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapisuje dane w buforze wyjściowym portu szeregowego.
Przeciążenia
| Nazwa | Opis |
|---|---|
| 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
- Ź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 -> unitPublic Sub Write (text As String)Parametry
- text
- String
Ciąg danych wyjściowych.
Wyjątki
Określony port nie jest otwarty.
Parametr text ma wartość null.
Operacja nie została ukończona przed zakończeniem okresu przekroczenia 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 ustawiona na XOnXOff wartość , SerialPort obiekt może zgłosić TimeoutException czas oczekiwania na gotowość urządzenia do zaakceptowania większej ilości danych.
Domyślnie SerialPort używa ASCIIEncoding metody 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
- Ź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 -> unitPublic 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 rozpoczyna się kopiowanie bajtów do portu.
- count
- Int32
Liczba bajtów do zapisu.
Wyjątki
Przekazana wartość buffer to null.
Określony port nie jest otwarty.
Parametry offset lub 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ść bufferobiektu .
Operacja nie została ukończona przed zakończeniem okresu przekroczenia 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 ustawiona na XOnXOff wartość , SerialPort obiekt może zgłosić TimeoutException czas oczekiwania na gotowość urządzenia do zaakceptowania większej ilości danych.
Dotyczy
Write(Char[], Int32, Int32)
- Źródło:
- SerialPort.cs
- Ź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 -> unitPublic 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 rozpoczyna się kopiowanie bajtów do portu.
- count
- Int32
Liczba znaków do zapisania.
Wyjątki
Przekazana wartość buffer to null.
Określony port nie jest otwarty.
Parametry offset lub 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ść bufferobiektu .
Operacja nie została ukończona przed zakończeniem okresu przekroczenia 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 ustawiona na XOnXOff wartość , SerialPort obiekt może zgłosić TimeoutException czas oczekiwania na gotowość urządzenia do zaakceptowania większej ilości danych.
Domyślnie SerialPort używa ASCIIEncoding metody 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.
