MultichannelConnection Class

Base class for Link-OS printers which support separate printing and status channels.

Inheritance Hierarchy

SystemObject
  Zebra.Sdk.CommMultichannelConnection
    Zebra.Sdk.CommMultichannelBluetoothConnection
    Zebra.Sdk.CommMultichannelBluetoothConnection
    Zebra.Sdk.CommMultichannelTcpConnection

Namespace: Zebra.Sdk.Comm
Assembly: SdkApi.Core (in SdkApi.Core.dll) Version: 3.0.3271

Syntax

C++

Copy

public abstract class MultichannelConnection : ConnectionWithWriteLogging, 
	Connection

Public MustInherit Class MultichannelConnection
	Implements ConnectionWithWriteLogging, Connection

public ref class MultichannelConnection abstract : ConnectionWithWriteLogging, 
	Connection

The MultichannelConnection type exposes the following members.

Properties

	Name	Description
	Connected	Returns true if the connection is open.
	MaxTimeoutForRead	Gets or sets the maximum time, in milliseconds, to wait for any data to be received.
	PrintingChannel	Gets the underlying printing Connection of this MultichannelConnection.
	SimpleConnectionName	Gets a human-readable description of the connection.
	StatusChannel	Gets the underlying status StatusConnection of this MultichannelConnection.
	TimeToWaitForMoreData	Gets or sets the maximum time, in milliseconds, to wait in-between reads after the initial read.

Top

Methods

	Name	Description
	AddWriteLogStream	Sets the stream to log the write data to.
	BytesAvailable	Returns an estimate of the number of bytes that can be read from this connection without blocking.
	Close	Closes both the printing and status channels of this MultichannelConnection.
	ClosePrintingChannel	Closes the printing channel of this MultichannelConnection.
	CloseStatusChannel	Closes the status channel of this MultichannelConnection.
	Equals	(Inherited from Object)
	GetConnectionReestablisher	Returns a ConnectionReestablisher which allows for easy recreation of a connection which may have been closed.
	GetHashCode	(Inherited from Object)
	GetType	(Inherited from Object)
	Open	Opens both the printing and status channel of this Multichannel connection.
	OpenPrintingChannel	Opens the printing channel of this Multichannel connection.
	OpenStatusChannel	Opens the status channel of this Multichannel connection.
	Read	Reads all the available data from the connection. This call is non-blocking.
	Read(BinaryWriter)	Reads all the available data from the connection.
	ReadChar	Reads the next byte of data from the connection.
	SendAndWaitForResponse(Byte, Int32, Int32, String)	Sends dataToSend and returns the response data.
	SendAndWaitForResponse(BinaryWriter, BinaryReader, Int32, Int32, String)	Sends data from sourceStream and writes the response data to destinationStream.
	SendAndWaitForValidResponse(Byte, Int32, Int32, ResponseValidator)	Sends dataToSend and returns the response data.
	SendAndWaitForValidResponse(BinaryWriter, BinaryReader, Int32, Int32, ResponseValidator)	Sends data from sourceStream and writes the response data to destinationStream.
	ToString	(Inherited from Object)
	WaitForData	Causes the currently executing thread to sleep until BytesAvailable > 0, or for a maximum of maxTimeout milliseconds.
	Write(BinaryReader)	Writes all available bytes from the data source to this output stream.
	Write(Byte)	Writes data.Length bytes from the specified byte array to this output stream.
	Write(Byte, Int32, Int32)	Writes length bytes from data starting at offset.

Top

Remarks

This class conforms to a standard Connection and if only the Connection methods are used, the SDK will attempt to open both the printing and status channels. A MultichannelConnection will use the raw Connection when a method is called directly. Furthermore, when using a ZebraPrinterLinkOs in conjunction with a MultichannelConnection, the ZebraPrinterLinkOs will attempt to use whichever connection is the most efficient. If you wish to only open up a specific channel, use either the OpenPrintingChannel or OpenStatusChannel method and their corresponding ClosePrintingChannel and CloseStatusChannel method.

Reference

Zebra.Sdk.Comm Namespace