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

Loads and compiles the specified XQuery program and returns an XQueryXQueryXQuery object that represents the XQuery program. The specified static context settings are used.

Syntax

Public Shared Function Compile( _
    stream As System.IO.FileStream, _
    settings As XQuerySettings _
) As XQuery
public static XQuery Compile(
    System.IO.FileStream stream,
    XQuerySettings settings
)
public:
static XQuery^ Compile(
    System.IO::FileStream^ stream, 
    XQuerySettings^ settings
)
 

Parameters

stream

Type: System.IO.FileStreamSystem.IO.FileStreamSystem.IO::FileStream^

The stream from which to read the XQuery program.

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
ArgumentNullExceptionArgumentNullExceptionArgumentNullExceptionThrown if stream 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.

The NameNameName property of stream is used to compute the the base URI of the query if the query does not include a base-uri declaration.