Maps a URI to an Object containing the actual resource.
[Visual Basic] MustOverride Public Function GetEntity( _ ByVal baseUri As String, _ ByVal relativeUri As String, _ ByVal role As String, _ ByVal type As Type, _ ByRef resolvedUri As String _ ) As Object [C#] public abstract object GetEntity( string baseUri, string relativeUri, string role, Type type, ref string resolvedUri ); [C++] public: virtual Object* GetEntity( String* baseUri, String* relativeUri, String* role, Type* type, String** resolvedUri ) = 0; [JScript] public abstract function GetEntity( baseUri : String, relativeUri : String, role : String, type : Type, resolvedUri : String ) : Object;
The caller can then use this information to check for circular dependencies. Another use of this might someone who is implementing cross-domain data security policy. The returnedtakes into account any HTTP redirections- which is required for such a security mechanism to be fully secure.
Returns the object matching the requested Type or null if the Type is not supported or if the URI is not resolvable.
Exception Type | Condition |
---|---|
Exception | if there is any sort of runtime error like a connection to a server is down, etc. |
This method is used when the caller wants to map a given URI into the Object containing the actual resource that that URI represents. The type of object returned is negotiable but the implemention must at least always support System.IO.Stream.
Other implementations may provide even higher level objects representing for even greater efficiency. For example, pre-compiled Schemas for validation or pre-compiled XSL stylesheets for use during transformation.
XmlResolver Class | XmlResolver Members | System.NewXml Namespace