IDocumentResolver.Resolve MethodIDocumentResolver.Resolve MethodIDocumentResolver::Resolve Method

Resolves a URI to a document.

Syntax

Function Resolve( _
    uri As AnyUri, _
    documentSet As DocumentSet, _
    nameTable As System.Xml.XmlNameTable, _
    whitespaceSettings As XsltWhitespaceSettings _
) As System.Xml.XPath.IXPathNavigable
System.Xml.XPath.IXPathNavigable Resolve(
    AnyUri uri,
    DocumentSet documentSet,
    System.Xml.XmlNameTable nameTable,
    XsltWhitespaceSettings whitespaceSettings
)
System.Xml.XPath::IXPathNavigable^ Resolve(
    AnyUri^ uri, 
    DocumentSet^ documentSet, 
    System.Xml::XmlNameTable^ nameTable, 
    XsltWhitespaceSettings^ whitespaceSettings
)
 

Parameters

uri

Type: XmlPrime.AnyUriXmlPrime.AnyUriXmlPrime::AnyUri^

The absolute URI of the document to resolve.

documentSet

Type: XmlPrime.DocumentSetXmlPrime.DocumentSetXmlPrime::DocumentSet^

The document set which can be used to retrieve resources required to retrieve the document (for example this can be used to retrieve an unparsed resource).

nameTable

Type: System.Xml.XmlNameTableSystem.Xml.XmlNameTableSystem.Xml::XmlNameTable^

The name table to use to load the document.

whitespaceSettings

Type: XmlPrime.XsltWhitespaceSettingsXmlPrime.XsltWhitespaceSettingsXmlPrime::XsltWhitespaceSettings^

The whitespace settings.

Return Value

Type: System.Xml.XPath.IXPathNavigableSystem.Xml.XPath.IXPathNavigableSystem.Xml.XPath::IXPathNavigable^

An IXPathNavigableIXPathNavigableIXPathNavigable instance representing the document for the specified URI, or null a null reference (Nothing in Visual Basic) nullptr if the URI can not be mapped to a document.

Remarks

A return value of null a null reference (Nothing in Visual Basic) nullptr indicates that uri is not supported by this resolver (for example an unsupported URI scheme). If the URI does have meaning to this resolver but there was an error retrieving the document then an exception should be thrown.

The document URI of the returned document must either be uri or the empty string.