Click or drag to resize

TcpStatusConnection Class

Establishes a status only TCP connection to a device
Inheritance Hierarchy
SystemObject
  Zebra.Sdk.CommConnectionA
    Zebra.Sdk.CommTcpConnection
      Zebra.Sdk.CommTcpStatusConnection

Namespace: Zebra.Sdk.Comm
Assembly: SdkApi.Core (in SdkApi.Core.dll) Version: 3.0.3271
Syntax
public class TcpStatusConnection : TcpConnection, 
	StatusConnectionWithWriteLogging, StatusConnection, Connection

The TcpStatusConnection type exposes the following members.

Constructors
 NameDescription
Public methodTcpStatusConnection(String) Initializes a new status only instance of the TcpStatusConnection class using the default status port of DEFAULT_STATUS_TCP_PORT 9200.
Public methodTcpStatusConnection(String, Int32) Initializes a new status only instance of the TcpStatusConnection class.
Public methodTcpStatusConnection(String, Int32, Int32, Int32) Initializes a new status only instance of the TcpStatusConnection class.
Top
Properties
 NameDescription
Public propertyAddress Returns the address which was passed into the constructor.
(Inherited from TcpConnection)
Public propertyConnected Returns true if the connection is open.
(Inherited from ConnectionA)
Public propertyManufacturer See the classes which implement this property for the format of the printer manufacturer string.
(Inherited from ConnectionA)
Public propertyMaxDataToWrite Gets or sets the maximum number of bytes to write at one time
(Inherited from ConnectionA)
Public propertyMaxTimeoutForRead Gets or sets the maximum time, in milliseconds, to wait for any data to be received.
(Inherited from ConnectionA)
Public propertyMultipartTimeToWaitAfterSend
(Inherited from ConnectionA)
Public propertyPortNumber Returns the port number which was passed into the constructor.
(Inherited from TcpConnection)
Public propertySimpleConnectionName Returns the IP address and the status port as the description.
(Overrides TcpConnectionSimpleConnectionName)
Public propertyTimeToWaitForMoreData Gets or sets the maximum time, in milliseconds, to wait in-between reads after the initial read.
(Inherited from ConnectionA)
Top
Methods
 NameDescription
Public methodAddWriteLogStream Sets the stream to log the write data to.
(Inherited from ConnectionA)
Public methodBytesAvailable Returns an estimate of the number of bytes that can be read from this connection without blocking.
(Inherited from TcpConnection)
Public methodClose Closes this connection and releases any system resources associated with the connection.
(Inherited from ConnectionA)
Public methodEquals
(Inherited from Object)
Public methodGetConnectionReestablisher Returns a ConnectionReestablisher which allows for easy recreation of a connection which may have been closed.
(Inherited from TcpConnection)
Public methodGetHashCode
(Inherited from Object)
Public methodGetType
(Inherited from Object)
Public methodOpen Opens the connection to a device.
(Inherited from ConnectionA)
Public methodRead Reads all the available data from the connection. This call is non-blocking.
(Inherited from ConnectionA)
Public methodRead(BinaryWriter) Reads all the available data from the connection.
(Inherited from ConnectionA)
Public methodRead(Int32) Reads maxBytesToRead of the available data from the connection.
(Inherited from ConnectionA)
Public methodRead(Int32, Boolean) Reads maxBytesToRead of the available data from the connection.
(Inherited from ConnectionA)
Public methodReadChar Reads the next byte of data from the connection.
(Inherited from ConnectionA)
Public methodSendAndWaitForResponse(Byte, Int32, Int32, String) Sends dataToSend and returns the response data.
(Inherited from ConnectionA)
Public methodSendAndWaitForResponse(BinaryWriter, BinaryReader, Int32, Int32, String) Sends data from sourceStream and writes the response data to destinationStream.
(Inherited from ConnectionA)
Public methodSendAndWaitForValidResponse(Byte, Int32, Int32, ResponseValidator) Sends dataToSend and returns the response data.
(Inherited from ConnectionA)
Public methodSendAndWaitForValidResponse(BinaryWriter, BinaryReader, Int32, Int32, ResponseValidator) Sends data from sourceStream and writes the response data to destinationStream.
(Inherited from ConnectionA)
Public methodSetReadTimeout Sets the read timeout on the underlying socket.
(Inherited from TcpConnection)
Public methodToString The address and port number are the parameters which were passed into the constructor.
(Overrides TcpConnectionToString)
Public methodWaitForData Causes the currently executing thread to sleep until BytesAvailable > 0, or for a maximum of maxTimeout milliseconds.
(Inherited from ConnectionA)
Public methodWrite(BinaryReader) Writes all available bytes from the data source to this output stream.
(Inherited from ConnectionA)
Public methodWrite(Byte) Writes data.Length bytes from the specified byte array to this output stream.
(Inherited from ConnectionA)
Public methodWrite(Byte, Int32, Int32) Writes length bytes from data starting at offset.
(Inherited from ConnectionA)
Top
Fields
 NameDescription
Public fieldStatic memberDEFAULT_STATUS_TCP_PORT The default Status TCP port for ZPL devices.
Top
Example
C#
using System;
using Zebra.Sdk.Comm;
using Zebra.Sdk.Printer;

public class TcpStatusConnectionExample {

    public static void Main(string[] args) {
        new TcpStatusConnectionExample().SendJSONOverStatusChannel("1.2.3.4");
    }

    private void SendJSONOverStatusChannel(string theIpAddress) {
        // Instantiate connection for ZPL TCP port at given address
        Connection thePrinterConn = new TcpStatusConnection(theIpAddress, TcpStatusConnection.DEFAULT_STATUS_TCP_PORT);

        try {
            // Open the connection - physical connection is established here.
            thePrinterConn.Open();

            // This sends down JSON to the status channel to retrieve the 'appl.name' setting
            string firmwareVersion = SGD.GET("appl.name", thePrinterConn);
            Console.WriteLine("The firmware version is : " + firmwareVersion);
        } catch (ConnectionException e) {
            // Handle communications error here.
            Console.WriteLine(e.ToString());
        } finally {
            // Close the connection to release resources.
            thePrinterConn.Close();
        }
    }
}
See Also