PrintQueue.GetPrintCapabilitiesAsXml Method

Definition

Namespace:

System.Printing

Assembly:

System.Printing.dll

Gets a MemoryStream object that specifies the printer's capabilities as an XML stream that complies with the Print Schema.

Overloads

GetPrintCapabilitiesAsXml()	Gets a MemoryStream object that specifies the printer's capabilities as an XML stream that complies with the Print Schema.
GetPrintCapabilitiesAsXml(PrintTicket)	Gets a MemoryStream object that specifies the printer's capabilities in an XML format that complies with the Print Schema.

Remarks

The XML schema used is called "PrintCapabilities," a part of the Print Schema system.

GetPrintCapabilitiesAsXml()

Gets a MemoryStream object that specifies the printer's capabilities as an XML stream that complies with the Print Schema.

public:
 System::IO::MemoryStream ^ GetPrintCapabilitiesAsXml();

public System.IO.MemoryStream GetPrintCapabilitiesAsXml ();

member this.GetPrintCapabilitiesAsXml : unit -> System.IO.MemoryStream

Public Function GetPrintCapabilitiesAsXml () As MemoryStream

Returns

MemoryStream

A MemoryStream specifying the printer's capabilities by using the XML schema "PrintCapabilities," a part of the Print Schema system.

Exceptions

PrintQueueException

The print capabilities could not be retrieved.

GetPrintCapabilitiesAsXml(PrintTicket)

Gets a MemoryStream object that specifies the printer's capabilities in an XML format that complies with the Print Schema.

public:
 System::IO::MemoryStream ^ GetPrintCapabilitiesAsXml(System::Printing::PrintTicket ^ printTicket);

public System.IO.MemoryStream GetPrintCapabilitiesAsXml (System.Printing.PrintTicket printTicket);

member this.GetPrintCapabilitiesAsXml : System.Printing.PrintTicket -> System.IO.MemoryStream

Public Function GetPrintCapabilitiesAsXml (printTicket As PrintTicket) As MemoryStream

Parameters

printTicket

PrintTicket

A print ticket that provides the basis on which the print capabilities are reported.

Returns

MemoryStream

A MemoryStream specifying the printer's capabilities by using the XML schema "PrintCapabilities," a part of the Print Schema system.

Exceptions

PrintQueueException

The print capabilities could not be retrieved.

ArgumentException

printTicket is not well-formed.

Remarks

The PrintTicket parameter is used as the basis on which to construct the print capabilities XML. For example, suppose the printer supported only media types A and B from input bin 1 and it only supported media type C from input bin 2. If the printTicket parameter specified input bin 1, then the print capabilities XML that is returned would include all three media types, but it would report type C as "constrained." If the printTicket parameter specified input bin 2, then the print capabilities XML that is returned would include all three media types, but it would report types A and B as "constrained." See the Print Schema for more information on constraints.

If printTicket is null, the UserPrintTicket is used.