SerialPort.DataReceived Olay

Tanım

Ad Alanı:

System.IO.Ports

Bütünleştirilmiş Kod:

System.IO.Ports.dll

Paket:

System.IO.Ports v11.0.0-preview.2.26159.112

Kaynak:

SerialPort.cs

Verilerin nesnesi tarafından SerialPort temsil edilen bir bağlantı noktası üzerinden alındığını gösterir.

public:
 event System::IO::Ports::SerialDataReceivedEventHandler ^ DataReceived;

public event System.IO.Ports.SerialDataReceivedEventHandler DataReceived;

member this.DataReceived : System.IO.Ports.SerialDataReceivedEventHandler 

Public Custom Event DataReceived As SerialDataReceivedEventHandler 

Olay Türü

SerialDataReceivedEventHandler

Örnekler

Bu örnek, COM1 bağlantı noktasında alınan tüm kullanılabilir verileri okumak için öğesine SerialDataReceivedEventHandlerDataReceived ekler. Bu kodu test etmek için, verileri gönderecek COM1'e bağlı bir donanım olması gerekir.

using System;
using System.IO.Ports;

class PortDataReceived
{
    public static void Main()
    {
        SerialPort mySerialPort = new SerialPort("COM1");

        mySerialPort.BaudRate = 9600;
        mySerialPort.Parity = Parity.None;
        mySerialPort.StopBits = StopBits.One;
        mySerialPort.DataBits = 8;
        mySerialPort.Handshake = Handshake.None;
        mySerialPort.RtsEnable = true;

        mySerialPort.DataReceived += new SerialDataReceivedEventHandler(DataReceivedHandler);

        mySerialPort.Open();

        Console.WriteLine("Press any key to continue...");
        Console.WriteLine();
        Console.ReadKey();
        mySerialPort.Close();
    }

    private static void DataReceivedHandler(
                        object sender,
                        SerialDataReceivedEventArgs e)
    {
        SerialPort sp = (SerialPort)sender;
        string indata = sp.ReadExisting();
        Console.WriteLine("Data Received:");
        Console.Write(indata);
    }
}

Imports System.IO.Ports

Class PortDataReceived
    Public Shared Sub Main()
        Dim mySerialPort As New SerialPort("COM1")

        mySerialPort.BaudRate = 9600
        mySerialPort.Parity = Parity.None
        mySerialPort.StopBits = StopBits.One
        mySerialPort.DataBits = 8
        mySerialPort.Handshake = Handshake.None
        mySerialPort.RtsEnable = True

        AddHandler mySerialPort.DataReceived, AddressOf DataReceivedHandler

        mySerialPort.Open()

        Console.WriteLine("Press any key to continue...")
        Console.WriteLine()
        Console.ReadKey()
        mySerialPort.Close()
    End Sub

    Private Shared Sub DataReceivedHandler(
                        sender As Object,
                        e As SerialDataReceivedEventArgs)
        Dim sp As SerialPort = CType(sender, SerialPort)
        Dim indata As String = sp.ReadExisting()
        Console.WriteLine("Data Received:")
        Console.Write(indata)
    End Sub
End Class

Açıklamalar

Veri olayları, numaralandırmadaki SerialData öğelerden herhangi birinden kaynaklanabilir. İşletim sistemi bu olayın tetiklenip tetiklenmeyeceğini belirlediğinden, tüm eşlik hataları bildirilmeyebilir.

İç DataReceived giriş arabelleğindeki bayt sayısından ve özelliğin değerinden ReceivedBytesThreshold bağımsız olarak bir Eof karakteri alınırsa da olay oluşturulur.

PinChanged, DataReceivedve ErrorReceived olayları sıra dışı çağrılabilir ve temel alınan akışın hatayı bildirmesi ile olay işleyicisinin yürütülmesi arasında küçük bir gecikme olabilir. Aynı anda yalnızca bir olay işleyicisi yürütülebilir.

Olayın DataReceived alınan her bayt için yükseltilmesi garanti değildir. Arabellekte BytesToRead okunacak veri miktarını belirlemek için özelliğini kullanın.

Nesneden DataReceived veri alındığında olay ikincil bir iş parçacığında SerialPort oluşturulur. Bu olay ana iş parçacığında değil ikincil iş parçacığında tetiklendiğinden, ui öğeleri gibi ana iş parçacığındaki bazı öğeleri değiştirmeye çalışmak iş parçacığı özel durumu oluşturabilir. main Form veya Controliçindeki öğeleri değiştirmek gerekiyorsa, değişiklik isteklerini kullanarak Invokegeri gönderin. Bu işlem, işi uygun iş parçacığında yapar.

Olayları işleme hakkında daha fazla bilgi için bkz . Olayları İşleme ve Oluşturma.