SerialPort SerialPort SerialPort SerialPort Class

Definição

Representa um recurso de porta serial.Represents a serial port resource.

public ref class SerialPort : System::ComponentModel::Component
public class SerialPort : System.ComponentModel.Component
type SerialPort = class
    inherit Component
Public Class SerialPort
Inherits Component
Herança

Exemplos

O exemplo de código a seguir demonstra o uso SerialPort da classe para permitir que dois usuários conversem de dois computadores separados conectados por um cabo de modem nulo.The following code example demonstrates the use of the SerialPort class to allow two users to chat from two separate computers connected by a null modem cable. Neste exemplo, os usuários são solicitados a fornecer as configurações de porta e um nome de usuário antes de bater papo.In this example, the users are prompted for the port settings and a username before chatting. Ambos os computadores devem executar o programa para obter a funcionalidade completa deste exemplo.Both computers must be executing the program to achieve full functionality of this example.

#using <System.dll>

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

public ref class PortChat
{
private:
    static bool _continue;
    static SerialPort^ _serialPort;

public:
    static void Main()
    {
        String^ name;
        String^ message;
        StringComparer^ stringComparer = StringComparer::OrdinalIgnoreCase;
        Thread^ readThread = gcnew Thread(gcnew ThreadStart(PortChat::Read));

        // Create a new SerialPort object with default settings.
        _serialPort = gcnew SerialPort();

        // Allow the user to set the appropriate properties.
        _serialPort->PortName = SetPortName(_serialPort->PortName);
        _serialPort->BaudRate = SetPortBaudRate(_serialPort->BaudRate);
        _serialPort->Parity = SetPortParity(_serialPort->Parity);
        _serialPort->DataBits = SetPortDataBits(_serialPort->DataBits);
        _serialPort->StopBits = SetPortStopBits(_serialPort->StopBits);
        _serialPort->Handshake = SetPortHandshake(_serialPort->Handshake);

        // Set the read/write timeouts
        _serialPort->ReadTimeout = 500;
        _serialPort->WriteTimeout = 500;

        _serialPort->Open();
        _continue = true;
        readThread->Start();

        Console::Write("Name: ");
        name = Console::ReadLine();

        Console::WriteLine("Type QUIT to exit");

        while (_continue)
        {
            message = Console::ReadLine();

            if (stringComparer->Equals("quit", message))
            {
                _continue = false;
            }
            else
            {
                _serialPort->WriteLine(
                    String::Format("<{0}>: {1}", name, message) );
            }
        }

        readThread->Join();
        _serialPort->Close();
    }

    static void Read()
    {
        while (_continue)
        {
            try
            {
                String^ message = _serialPort->ReadLine();
                Console::WriteLine(message);
            }
            catch (TimeoutException ^) { }
        }
    }

    static String^ SetPortName(String^ defaultPortName)
    {
        String^ portName;

        Console::WriteLine("Available Ports:");
        for each (String^ s in SerialPort::GetPortNames())
        {
            Console::WriteLine("   {0}", s);
        }

        Console::Write("Enter COM port value (Default: {0}): ", defaultPortName);
        portName = Console::ReadLine();

        if (portName == "")
        {
            portName = defaultPortName;
        }
        return portName;
    }

    static Int32 SetPortBaudRate(Int32 defaultPortBaudRate)
    {
        String^ baudRate;

        Console::Write("Baud Rate(default:{0}): ", defaultPortBaudRate);
        baudRate = Console::ReadLine();

        if (baudRate == "")
        {
            baudRate = defaultPortBaudRate.ToString();
        }

        return Int32::Parse(baudRate);
    }

    static Parity SetPortParity(Parity defaultPortParity)
    {
        String^ parity;

        Console::WriteLine("Available Parity options:");
        for each (String^ s in Enum::GetNames(Parity::typeid))
        {
            Console::WriteLine("   {0}", s);
        }
        
        Console::Write("Enter Parity value (Default: {0}):", defaultPortParity.ToString());
        parity = Console::ReadLine();

        if (parity == "")
        {
            parity = defaultPortParity.ToString();
        }

        return (Parity)Enum::Parse(Parity::typeid, parity);
    }

    static Int32 SetPortDataBits(Int32 defaultPortDataBits)
    {
        String^ dataBits;

        Console::Write("Enter DataBits value (Default: {0}): ", defaultPortDataBits);
        dataBits = Console::ReadLine();

        if (dataBits == "")
        {
            dataBits = defaultPortDataBits.ToString();
        }

        return Int32::Parse(dataBits);
    }

    static StopBits SetPortStopBits(StopBits defaultPortStopBits)
    {
        String^ stopBits;

        Console::WriteLine("Available Stop Bits options:");
        for each (String^ s in Enum::GetNames(StopBits::typeid))
        {
            Console::WriteLine("   {0}", s);
        }

        Console::Write("Enter StopBits value (None is not supported and \n" +
            "raises an ArgumentOutOfRangeException. \n (Default: {0}):", defaultPortStopBits.ToString());
        stopBits = Console::ReadLine();

        if (stopBits == "")
        {
            stopBits = defaultPortStopBits.ToString();
        }

        return (StopBits)Enum::Parse(StopBits::typeid, stopBits);
    }

    static Handshake SetPortHandshake(Handshake defaultPortHandshake)
    {
        String^ handshake;

        Console::WriteLine("Available Handshake options:");
        for each (String^ s in Enum::GetNames(Handshake::typeid))
        {
            Console::WriteLine("   {0}", s);
        }

        Console::Write("Enter Handshake value (Default: {0}):", defaultPortHandshake.ToString());
        handshake = Console::ReadLine();

        if (handshake == "")
        {
            handshake = defaultPortHandshake.ToString();
        }

        return (Handshake)Enum::Parse(Handshake::typeid, handshake);
    }
};

int main()
{
    PortChat::Main();
}
// Use this code inside a project created with the Visual C# > Windows Desktop > Console Application template.
// Replace the code in Program.cs with this code.

using System;
using System.IO.Ports;
using System.Threading;

public class PortChat
{
    static bool _continue;
    static SerialPort _serialPort;

    public static void Main()
    {
        string name;
        string message;
        StringComparer stringComparer = StringComparer.OrdinalIgnoreCase;
        Thread readThread = new Thread(Read);

        // Create a new SerialPort object with default settings.
        _serialPort = new SerialPort();

        // Allow the user to set the appropriate properties.
        _serialPort.PortName = SetPortName(_serialPort.PortName);
        _serialPort.BaudRate = SetPortBaudRate(_serialPort.BaudRate);
        _serialPort.Parity = SetPortParity(_serialPort.Parity);
        _serialPort.DataBits = SetPortDataBits(_serialPort.DataBits);
        _serialPort.StopBits = SetPortStopBits(_serialPort.StopBits);
        _serialPort.Handshake = SetPortHandshake(_serialPort.Handshake);

        // Set the read/write timeouts
        _serialPort.ReadTimeout = 500;
        _serialPort.WriteTimeout = 500;

        _serialPort.Open();
        _continue = true;
        readThread.Start();

        Console.Write("Name: ");
        name = Console.ReadLine();

        Console.WriteLine("Type QUIT to exit");

        while (_continue)
        {
            message = Console.ReadLine();

            if (stringComparer.Equals("quit", message))
            {
                _continue = false;
            }
            else
            {
                _serialPort.WriteLine(
                    String.Format("<{0}>: {1}", name, message));
            }
        }

        readThread.Join();
        _serialPort.Close();
    }

    public static void Read()
    {
        while (_continue)
        {
            try
            {
                string message = _serialPort.ReadLine();
                Console.WriteLine(message);
            }
            catch (TimeoutException) { }
        }
    }

    // Display Port values and prompt user to enter a port.
    public static string SetPortName(string defaultPortName)
    {
        string portName;

        Console.WriteLine("Available Ports:");
        foreach (string s in SerialPort.GetPortNames())
        {
            Console.WriteLine("   {0}", s);
        }

        Console.Write("Enter COM port value (Default: {0}): ", defaultPortName);
        portName = Console.ReadLine();

        if (portName == "" || !(portName.ToLower()).StartsWith("com"))
        {
            portName = defaultPortName;
        }
        return portName;
    }
    // Display BaudRate values and prompt user to enter a value.
    public static int SetPortBaudRate(int defaultPortBaudRate)
    {
        string baudRate;

        Console.Write("Baud Rate(default:{0}): ", defaultPortBaudRate);
        baudRate = Console.ReadLine();

        if (baudRate == "")
        {
            baudRate = defaultPortBaudRate.ToString();
        }

        return int.Parse(baudRate);
    }

    // Display PortParity values and prompt user to enter a value.
    public static Parity SetPortParity(Parity defaultPortParity)
    {
        string parity;

        Console.WriteLine("Available Parity options:");
        foreach (string s in Enum.GetNames(typeof(Parity)))
        {
            Console.WriteLine("   {0}", s);
        }

        Console.Write("Enter Parity value (Default: {0}):", defaultPortParity.ToString(), true);
        parity = Console.ReadLine();

        if (parity == "")
        {
            parity = defaultPortParity.ToString();
        }

        return (Parity)Enum.Parse(typeof(Parity), parity, true);
    }
    // Display DataBits values and prompt user to enter a value.
    public static int SetPortDataBits(int defaultPortDataBits)
    {
        string dataBits;

        Console.Write("Enter DataBits value (Default: {0}): ", defaultPortDataBits);
        dataBits = Console.ReadLine();

        if (dataBits == "")
        {
            dataBits = defaultPortDataBits.ToString();
        }

        return int.Parse(dataBits.ToUpperInvariant());
    }

    // Display StopBits values and prompt user to enter a value.
    public static StopBits SetPortStopBits(StopBits defaultPortStopBits)
    {
        string stopBits;

        Console.WriteLine("Available StopBits options:");
        foreach (string s in Enum.GetNames(typeof(StopBits)))
        {
            Console.WriteLine("   {0}", s);
        }

        Console.Write("Enter StopBits value (None is not supported and \n" +
         "raises an ArgumentOutOfRangeException. \n (Default: {0}):", defaultPortStopBits.ToString());
        stopBits = Console.ReadLine();
       
        if (stopBits == "" )
        {
            stopBits = defaultPortStopBits.ToString();
        }

        return (StopBits)Enum.Parse(typeof(StopBits), stopBits, true);
    }
    public static Handshake SetPortHandshake(Handshake defaultPortHandshake)
    {
        string handshake;

        Console.WriteLine("Available Handshake options:");
        foreach (string s in Enum.GetNames(typeof(Handshake)))
        {
            Console.WriteLine("   {0}", s);
        }

        Console.Write("Enter Handshake value (Default: {0}):", defaultPortHandshake.ToString());
        handshake = Console.ReadLine();

        if (handshake == "")
        {
            handshake = defaultPortHandshake.ToString();
        }

        return (Handshake)Enum.Parse(typeof(Handshake), handshake, true);
    }
}
' Use this code inside a project created with the Visual Basic > Windows Desktop > Console Application template.
' Replace the default code in Module1.vb with this code. Then right click the project in Solution Explorer,
' select Properties, and set the Startup Object to PortChat.

Imports System.IO.Ports
Imports System.Threading

Public Class PortChat
    Shared _continue As Boolean
    Shared _serialPort As SerialPort

    Public Shared Sub Main()
        Dim name As String
        Dim message As String
        Dim stringComparer__1 As StringComparer = StringComparer.OrdinalIgnoreCase
        Dim readThread As New Thread(AddressOf Read)

        ' Create a new SerialPort object with default settings.
        _serialPort = New SerialPort()

        ' Allow the user to set the appropriate properties.
        _serialPort.PortName = SetPortName(_serialPort.PortName)
        _serialPort.BaudRate = SetPortBaudRate(_serialPort.BaudRate)
        _serialPort.Parity = SetPortParity(_serialPort.Parity)
        _serialPort.DataBits = SetPortDataBits(_serialPort.DataBits)
        _serialPort.StopBits = SetPortStopBits(_serialPort.StopBits)
        _serialPort.Handshake = SetPortHandshake(_serialPort.Handshake)

        ' Set the read/write timeouts
        _serialPort.ReadTimeout = 500
        _serialPort.WriteTimeout = 500

        _serialPort.Open()
        _continue = True
        readThread.Start()

        Console.Write("Name: ")
        name = Console.ReadLine()

        Console.WriteLine("Type QUIT to exit")

        While _continue
            message = Console.ReadLine()

            If stringComparer__1.Equals("quit", message) Then
                _continue = False
            Else
                _serialPort.WriteLine([String].Format("<{0}>: {1}", name, message))
            End If
        End While

        readThread.Join()
        _serialPort.Close()
    End Sub

    Public Shared Sub Read()
        While _continue
            Try
                Dim message As String = _serialPort.ReadLine()
                Console.WriteLine(message)
            Catch generatedExceptionName As TimeoutException
            End Try
        End While
    End Sub

    ' Display Port values and prompt user to enter a port.
    Public Shared Function SetPortName(defaultPortName As String) As String
        Dim portName As String

        Console.WriteLine("Available Ports:")
        For Each s As String In SerialPort.GetPortNames()
            Console.WriteLine("   {0}", s)
        Next

        Console.Write("Enter COM port value (Default: {0}): ", defaultPortName)
        portName = Console.ReadLine()

        If portName = "" OrElse Not (portName.ToLower()).StartsWith("com") Then
            portName = defaultPortName
        End If
        Return portName
    End Function
    ' Display BaudRate values and prompt user to enter a value.
    Public Shared Function SetPortBaudRate(defaultPortBaudRate As Integer) As Integer
        Dim baudRate As String

        Console.Write("Baud Rate(default:{0}): ", defaultPortBaudRate)
        baudRate = Console.ReadLine()

        If baudRate = "" Then
            baudRate = defaultPortBaudRate.ToString()
        End If

        Return Integer.Parse(baudRate)
    End Function

    ' Display PortParity values and prompt user to enter a value.
    Public Shared Function SetPortParity(defaultPortParity As Parity) As Parity
        Dim parity As String

        Console.WriteLine("Available Parity options:")
        For Each s As String In [Enum].GetNames(GetType(Parity))
            Console.WriteLine("   {0}", s)
        Next

        Console.Write("Enter Parity value (Default: {0}):", defaultPortParity.ToString(), True)
        parity = Console.ReadLine()

        If parity = "" Then
            parity = defaultPortParity.ToString()
        End If

        Return CType([Enum].Parse(GetType(Parity), parity, True), Parity)
    End Function
    ' Display DataBits values and prompt user to enter a value.
    Public Shared Function SetPortDataBits(defaultPortDataBits As Integer) As Integer
        Dim dataBits As String

        Console.Write("Enter DataBits value (Default: {0}): ", defaultPortDataBits)
        dataBits = Console.ReadLine()

        If dataBits = "" Then
            dataBits = defaultPortDataBits.ToString()
        End If

        Return Integer.Parse(dataBits.ToUpperInvariant())
    End Function
    ' Display StopBits values and prompt user to enter a value.

    Public Shared Function SetPortStopBits(defaultPortStopBits As StopBits) As StopBits
        Dim stopBits As String

        Console.WriteLine("Available StopBits options:")
        For Each s As String In [Enum].GetNames(GetType(StopBits))
            Console.WriteLine("   {0}", s)
        Next

        Console.Write("Enter StopBits value (None is not supported and " &
                      vbLf & "raises an ArgumentOutOfRangeException. " &
                      vbLf & " (Default: {0}):", defaultPortStopBits.ToString())
        stopBits = Console.ReadLine()

        If stopBits = "" Then
            stopBits = defaultPortStopBits.ToString()
        End If

        Return CType([Enum].Parse(GetType(StopBits), stopBits, True), StopBits)
    End Function
    Public Shared Function SetPortHandshake(defaultPortHandshake As Handshake) As Handshake
        Dim handshake As String

        Console.WriteLine("Available Handshake options:")
        For Each s As String In [Enum].GetNames(GetType(Handshake))
            Console.WriteLine("   {0}", s)
        Next

        Console.Write("Enter Handshake value (Default: {0}):", defaultPortHandshake.ToString())
        handshake = Console.ReadLine()

        If handshake = "" Then
            handshake = defaultPortHandshake.ToString()
        End If

        Return CType([Enum].Parse(GetType(Handshake), handshake, True), Handshake)
    End Function
End Class

Comentários

Use essa classe para controlar um recurso de arquivo de porta serial.Use this class to control a serial port file resource. Essa classe fornece e/s síncrona e orientada por evento, acesso a Estados de PIN e de interrupção e acesso às propriedades do driver serial.This class provides synchronous and event-driven I/O, access to pin and break states, and access to serial driver properties. Além disso, a funcionalidade dessa classe pode ser encapsulada em um Stream objeto interno, acessível por BaseStream meio da propriedade e transmitida para classes que encapsulam ou usam fluxos.Additionally, the functionality of this class can be wrapped in an internal Stream object, accessible through the BaseStream property, and passed to classes that wrap or use streams.

A SerialPort classe dá suporte às seguintes codificações ASCIIEncoding: UTF8Encoding, UnicodeEncoding UTF32Encoding,, e qualquer codificação definida em mscorlib. dll em que a página de código é menor que 50000 ou a página de código é 54936.The SerialPort class supports the following encodings: ASCIIEncoding, UTF8Encoding, UnicodeEncoding, UTF32Encoding, and any encoding defined in mscorlib.dll where the code page is less than 50000 or the code page is 54936. Você pode usar codificações alternativas, mas deve usar o ReadByte método ou Write e executar a codificação por conta própria.You can use alternate encodings, but you must use the ReadByte or Write method and perform the encoding yourself.

Você usa o GetPortNames método para recuperar as portas válidas para o computador atual.You use the GetPortNames method to retrieve the valid ports for the current computer.

Se um SerialPort objeto for bloqueado durante uma operação de leitura, não anule o thread.If a SerialPort object becomes blocked during a read operation, do not abort the thread. Em vez disso, feche o fluxo base ou descarte o SerialPort objeto.Instead, either close the base stream or dispose of the SerialPort object.

Construtores

SerialPort() SerialPort() SerialPort() SerialPort()

Inicializa uma nova instância da classe SerialPort.Initializes a new instance of the SerialPort class.

SerialPort(IContainer) SerialPort(IContainer) SerialPort(IContainer) SerialPort(IContainer)

Inicializa uma nova instância da classe SerialPort usando o objeto IContainer especificado.Initializes a new instance of the SerialPort class using the specified IContainer object.

SerialPort(String) SerialPort(String) SerialPort(String) SerialPort(String)

Inicializa uma nova instância da classe SerialPort, usando o nome da porta especificado.Initializes a new instance of the SerialPort class using the specified port name.

SerialPort(String, Int32) SerialPort(String, Int32) SerialPort(String, Int32) SerialPort(String, Int32)

Inicializa uma nova instância da classe SerialPort usando a taxa de transmissão e o nome da porta especificadas.Initializes a new instance of the SerialPort class using the specified port name and baud rate.

SerialPort(String, Int32, Parity) SerialPort(String, Int32, Parity) SerialPort(String, Int32, Parity) SerialPort(String, Int32, Parity)

Inicializa uma nova instância da classe SerialPort usando o nome da porta, a taxa de transmissão e o bit de paridade especificados.Initializes a new instance of the SerialPort class using the specified port name, baud rate, and parity bit.

SerialPort(String, Int32, Parity, Int32) SerialPort(String, Int32, Parity, Int32) SerialPort(String, Int32, Parity, Int32) SerialPort(String, Int32, Parity, Int32)

Inicializa uma nova instância da classe SerialPort usando o nome da porta, a taxa de transmissão, o bit de paridade e os bits de dados especificados.Initializes a new instance of the SerialPort class using the specified port name, baud rate, parity bit, and data bits.

SerialPort(String, Int32, Parity, Int32, StopBits) SerialPort(String, Int32, Parity, Int32, StopBits) SerialPort(String, Int32, Parity, Int32, StopBits) SerialPort(String, Int32, Parity, Int32, StopBits)

Inicializa uma nova instância da classe SerialPort usando o nome da porta especificado, a taxa de transmissão, o bit de paridade, o bits de dados e o bit de parada.Initializes a new instance of the SerialPort class using the specified port name, baud rate, parity bit, data bits, and stop bit.

Campos

InfiniteTimeout InfiniteTimeout InfiniteTimeout InfiniteTimeout

Indica que nenhum tempo limite deve ocorrer.Indicates that no time-out should occur.

Propriedades

BaseStream BaseStream BaseStream BaseStream

Obtém o objeto Stream subjacente para um objeto SerialPort.Gets the underlying Stream object for a SerialPort object.

BaudRate BaudRate BaudRate BaudRate

Obtém ou define a taxa de transmissão serial.Gets or sets the serial baud rate.

BreakState BreakState BreakState BreakState

Obtém ou define o estado do sinal de interrupção.Gets or sets the break signal state.

BytesToRead BytesToRead BytesToRead BytesToRead

Obtém o número de bytes de dados no buffer de recepção.Gets the number of bytes of data in the receive buffer.

BytesToWrite BytesToWrite BytesToWrite BytesToWrite

Obtém o número de bytes de dados no buffer de envio.Gets the number of bytes of data in the send buffer.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CDHolding CDHolding CDHolding CDHolding

Obtém o estado da linha da Carrier Detectada da porta.Gets the state of the Carrier Detect line for the port.

Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
CtsHolding CtsHolding CtsHolding CtsHolding

Obtém o estado da linha Clear to Send.Gets the state of the Clear-to-Send line.

DataBits DataBits DataBits DataBits

Obtém ou define o tamanho padrão de bits de dados por byte.Gets or sets the standard length of data bits per byte.

DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DiscardNull DiscardNull DiscardNull DiscardNull

Obtém ou define um valor que indica se os bytes nulos são ignorados quando transmitidos entre a porta e o buffer de recepção.Gets or sets a value indicating whether null bytes are ignored when transmitted between the port and the receive buffer.

DsrHolding DsrHolding DsrHolding DsrHolding

Obtém o estado do sinal DSR (Data Set Ready).Gets the state of the Data Set Ready (DSR) signal.

DtrEnable DtrEnable DtrEnable DtrEnable

Obtém ou define um valor que habilita o sinal DTR (Data Terminal Ready) durante a comunicação serial.Gets or sets a value that enables the Data Terminal Ready (DTR) signal during serial communication.

Encoding Encoding Encoding Encoding

Obtém ou define a codificação de bytes para conversão de pré e pós-transmissão de texto.Gets or sets the byte encoding for pre- and post-transmission conversion of text.

Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Handshake Handshake Handshake Handshake

Obtém ou define o protocolo de handshake para transmissão da porta serial de dados usando um valor de Handshake.Gets or sets the handshaking protocol for serial port transmission of data using a value from Handshake.

IsOpen IsOpen IsOpen IsOpen

Obtém um valor que indica o status aberto ou fechado do objeto SerialPort.Gets a value indicating the open or closed status of the SerialPort object.

NewLine NewLine NewLine NewLine

Obtém ou define o valor usado para interpretar o final de uma chamada para os métodos ReadLine() e WriteLine(String).Gets or sets the value used to interpret the end of a call to the ReadLine() and WriteLine(String) methods.

Parity Parity Parity Parity

Obtém ou define o protocolo de verificação de paridade.Gets or sets the parity-checking protocol.

ParityReplace ParityReplace ParityReplace ParityReplace

Obtém ou define o byte que substitui bytes inválidos em um fluxo de dados quando ocorre um erro de paridade.Gets or sets the byte that replaces invalid bytes in a data stream when a parity error occurs.

PortName PortName PortName PortName

Obtém ou define a porta de comunicação, incluindo, sem limitação, todas as portas COM disponíveis.Gets or sets the port for communications, including but not limited to all available COM ports.

ReadBufferSize ReadBufferSize ReadBufferSize ReadBufferSize

Obtém ou define o tamanho do buffer de entrada do SerialPort.Gets or sets the size of the SerialPort input buffer.

ReadTimeout ReadTimeout ReadTimeout ReadTimeout

Obtém ou define o número de milissegundos antes que o tempo limite ocorra quando uma operação de leitura não for concluída.Gets or sets the number of milliseconds before a time-out occurs when a read operation does not finish.

ReceivedBytesThreshold ReceivedBytesThreshold ReceivedBytesThreshold ReceivedBytesThreshold

Obtém ou define o número de bytes no buffer de entrada interno antes que um evento DataReceived ocorra.Gets or sets the number of bytes in the internal input buffer before a DataReceived event occurs.

RtsEnable RtsEnable RtsEnable RtsEnable

Obtém ou define um valor que indica se o sinal RTS (solicitação de envio) está habilitado durante a comunicação serial.Gets or sets a value indicating whether the Request to Send (RTS) signal is enabled during serial communication.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
StopBits StopBits StopBits StopBits

Obtém ou define o número padrão de stopbits por byte.Gets or sets the standard number of stopbits per byte.

WriteBufferSize WriteBufferSize WriteBufferSize WriteBufferSize

Obtém ou define o tamanho do buffer de saída de porta serial.Gets or sets the size of the serial port output buffer.

WriteTimeout WriteTimeout WriteTimeout WriteTimeout

Obtém ou define o número de milissegundos antes que o tempo limite ocorra quando uma operação de gravação não for concluída.Gets or sets the number of milliseconds before a time-out occurs when a write operation does not finish.

Métodos

Close() Close() Close() Close()

Fecha a conexão de porta, define a propriedade IsOpen como false e descarta o objeto Stream interno.Closes the port connection, sets the IsOpen property to false, and disposes of the internal Stream object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DiscardInBuffer() DiscardInBuffer() DiscardInBuffer() DiscardInBuffer()

Descarta dados do buffer de recebimento do driver serial.Discards data from the serial driver's receive buffer.

DiscardOutBuffer() DiscardOutBuffer() DiscardOutBuffer() DiscardOutBuffer()

Descarta dados do buffer de transmissão do driver serial.Discards data from the serial driver's transmit buffer.

Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo SerialPort e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the SerialPort and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetPortNames() GetPortNames() GetPortNames() GetPortNames()

Obtém uma matriz de nomes de porta de série para o computador atual.Gets an array of serial port names for the current computer.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Open() Open() Open() Open()

Abre uma nova conexão de porta serial.Opens a new serial port connection.

Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32)

Lê um número de bytes por meio do buffer de entrada SerialPort e grava esses bytes em uma matriz de bytes no deslocamento especificado.Reads a number of bytes from the SerialPort input buffer and writes those bytes into a byte array at the specified offset.

Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32)

Lê um número de caracteres do buffer de entrada SerialPort e grava-os em uma matriz de caracteres em um deslocamento especificado.Reads a number of characters from the SerialPort input buffer and writes them into an array of characters at a given offset.

ReadByte() ReadByte() ReadByte() ReadByte()

Lê um byte do buffer de entrada SerialPort sincronicamente.Synchronously reads one byte from the SerialPort input buffer.

ReadChar() ReadChar() ReadChar() ReadChar()

Lê um caractere do buffer de entrada SerialPort de maneira síncrona.Synchronously reads one character from the SerialPort input buffer.

ReadExisting() ReadExisting() ReadExisting() ReadExisting()

Lê todos os bytes imediatamente disponíveis, baseado na codificação, no fluxo e no buffer de entrada do objeto SerialPort.Reads all immediately available bytes, based on the encoding, in both the stream and the input buffer of the SerialPort object.

ReadLine() ReadLine() ReadLine() ReadLine()

Lê até o valor NewLine no buffer de entrada.Reads up to the NewLine value in the input buffer.

ReadTo(String) ReadTo(String) ReadTo(String) ReadTo(String)

Lê uma cadeia de caracteres até o value especificado no buffer de entrada.Reads a string up to the specified value in the input buffer.

ToString() ToString() ToString() ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Inherited from Component)
Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Grava um número especificado de bytes na porta serial usando dados de um buffer.Writes a specified number of bytes to the serial port using data from a buffer.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Grava um número especificado de caracteres na porta serial usando dados de um buffer.Writes a specified number of characters to the serial port using data from a buffer.

Write(String) Write(String) Write(String) Write(String)

Grava a cadeia de caracteres especificada para a porta serial.Writes the specified string to the serial port.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Grava a cadeia de caracteres especificada e o valor de NewLine no buffer de saída.Writes the specified string and the NewLine value to the output buffer.

Eventos

DataReceived DataReceived DataReceived DataReceived

Indica que os dados foram recebidos por meio de uma porta representada pelo objeto SerialPort.Indicates that data has been received through a port represented by the SerialPort object.

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
ErrorReceived ErrorReceived ErrorReceived ErrorReceived

Indica que ocorreu um erro com uma porta representada por um objeto SerialPort.Indicates that an error has occurred with a port represented by a SerialPort object.

PinChanged PinChanged PinChanged PinChanged

Indica que ocorreu um evento de sinal sem dados na porta representada pelo objeto SerialPort.Indicates that a non-data signal event has occurred on the port represented by the SerialPort object.

Segurança

SecurityPermission
para a capacidade de chamar código não gerenciado.for the ability to call unmanaged code. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Aplica-se a