PrintQueue.GetPrintCapabilitiesAsXml Method

Definition

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

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

Exceptions

The print capabilities could not be retrieved.

Applies to

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

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

Exceptions

The print capabilities could not be retrieved.

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.

Applies to