Freigeben über


SerialPort.DataReceived Ereignis

Definition

Gibt an, dass Daten über einen Port empfangen wurden, der durch das SerialPort-Objekt dargestellt wird.

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 
Public Event DataReceived As SerialDataReceivedEventHandler 

Ereignistyp

Beispiele

In diesem Beispiel wird ein SerialDataReceivedEventHandler hinzugefügt, DataReceived um alle verfügbaren Daten zu lesen, die am COM1-Port empfangen werden. Beachten Sie, dass zum Testen dieses Codes Hardware an COM1 angefügt ist, die Daten sendet.

#using <System.dll>

using namespace System;
using namespace System::IO::Ports;

ref class PortDataReceived
{
public:
    static void Main()
    {
        SerialPort^ mySerialPort = gcnew 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 += gcnew 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);
    }
};

int main()
{
    PortDataReceived::Main();
}
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

Hinweise

Datenereignisse können von einem der Elemente in der SerialData Enumeration verursacht werden. Da das Betriebssystem bestimmt, ob dieses Ereignis ausgelöst werden soll oder nicht, werden möglicherweise nicht alle Paritätsfehler gemeldet.

Das DataReceived Ereignis wird auch ausgelöst, wenn ein Eof-Zeichen empfangen wird, unabhängig von der Anzahl von Bytes im internen Eingabepuffer und dem Wert der ReceivedBytesThreshold Eigenschaft.

PinChanged, DataReceived- und ErrorReceived -Ereignisse können in der fehlerhaften Reihenfolge aufgerufen werden, und es kann zu einer geringfügigen Verzögerung zwischen dem Fehler durch den zugrunde liegenden Stream und der Ausführung des Ereignishandlers kommen. Nur ein Ereignishandler kann gleichzeitig ausgeführt werden.

Es DataReceived ist nicht garantiert, dass das Ereignis für jedes empfangene Byte ausgelöst wird. Verwenden Sie die BytesToRead -Eigenschaft, um zu bestimmen, wie viele Daten im Puffer gelesen werden müssen.

Das DataReceived Ereignis wird in einem sekundären Thread ausgelöst, wenn Daten vom SerialPort -Objekt empfangen werden. Da dieses Ereignis für einen sekundären Thread und nicht für den Standard-Thread ausgelöst wird, könnte der Versuch, einige Elemente im Standard Thread zu ändern, z. B. Benutzeroberflächenelemente, eine Threading-Ausnahme auslösen. Wenn Elemente in der Standard Form oder Controlgeändert werden müssen, stellen Sie Änderungsanforderungen mithilfe von Invokezurück, wodurch die Arbeit am richtigen Thread ausgeführt wird.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für: