PrintCapabilities(Stream) Constructor
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the PrintCapabilities class by using an XML stream (that contains a PrintCapabilities document) that specifies printer capabilities and complies with the XML Print Schema.
public:
PrintCapabilities(System::IO::Stream ^ xmlStream);public PrintCapabilities (System.IO.Stream xmlStream);new System.Printing.PrintCapabilities : System.IO.Stream -> System.Printing.PrintCapabilitiesPublic Sub New (xmlStream As Stream)Parameters
- xmlStream
- Stream
An XML Stream that describes printer capabilities and conforms to the Print Schema.
Exceptions
xmlStream is null.
xmlStream is not valid XML.
Remarks
The entire PrintCapabilities document is stored in a non-public field in the object, including the XML elements within it that express less common features that are not represented by any of the public properties of the PrintCapabilities class. In fact, if the driver that produced the PrintCapabilities document is using a private extension of the Print Schema, that privately defined markup is also stored as part of the non-public PrintCapabilities document.
The private parts of the document, if any, are not validated by the constructor, but all Print Schema-defined parts are validated, including the parts that are not represented by any of the public properties of the PrintCapabilities class. Accordingly, the FormatException could be thrown even if all of the XML markup that corresponds to the public properties is valid.
