XQuery.Compile Method (XmlReader, XQuerySettings)XQuery.Compile Method (XmlReader, XQuerySettings)XQuery::Compile Method (XmlReader^, XQuerySettings^)

Compiles the XQuery program expressed using the XML Syntax for XQuery 1.0 (XQueryX) and returns an XQueryXQueryXQuery object that represents the XQuery program. The specified static context settings are used.

Syntax

Public Shared Function Compile( _
    reader As System.Xml.XmlReader, _
    settings As XQuerySettings _
) As XQuery
public static XQuery Compile(
    System.Xml.XmlReader reader,
    XQuerySettings settings
)
public:
static XQuery^ Compile(
    System.Xml::XmlReader^ reader, 
    XQuerySettings^ settings
)
 

Parameters

reader

Type: System.Xml.XmlReaderSystem.Xml.XmlReaderSystem.Xml::XmlReader^

An XmlReaderXmlReaderXmlReader instance positioned just before the beginning of an XQuery program expressed using the XML Syntax for XQuery 1.0 (XQueryX).

settings

Type: XmlPrime.XQuerySettingsXmlPrime.XQuerySettingsXmlPrime::XQuerySettings^

The initial static context settings.

Return Value

Type: XmlPrime.XQueryXmlPrime.XQueryXmlPrime::XQuery^

An XQueryXQueryXQuery object, or null a null reference (Nothing in Visual Basic) nullptr if an unrecoverable error was raised and handled by a subscriber to CompilationErrorCompilationErrorCompilationError

Exceptions

ExceptionCondition
ArgumentNullExceptionArgumentNullExceptionArgumentNullException reader or settings is null a null reference (Nothing in Visual Basic) nullptr.
XdmExceptionXdmExceptionXdmExceptionAn error occurred compiling the query.

Remarks

Any errors or warnings encountered during compilation raise the CompilationErrorCompilationErrorCompilationError event. If nothing subscribes to this event then an XdmExceptionXdmExceptionXdmException is thrown if an unrecoverable error is encountered. If this event is subscribed to then the exception is not thrown, and this method returns null a null reference (Nothing in Visual Basic) nullptr instead.