When overridden in a derived class, maps a URI to an object containing the actual resource.
Assembly: System.Xml (in System.Xml.dll)
'Declaration Public MustOverride Function GetEntity ( _ absoluteUri As Uri, _ role As String, _ ofObjectToReturn As Type _ ) As Object
- Type: System.String
The current version does not use this parameter when resolving URIs. This is provided for future extensibility purposes. For example, this can be mapped to the xlink:role and used as an implementation specific argument in other scenarios.
This method is used when the caller wants to map a given URI into the object containing the actual resource that the URI represents. The type of object returned is negotiable; however, the implementation must always support Stream.
Your application can mitigate memory Denial of Service threats to the method by implementing a wrapping implemented IStream that limits the number of bytes read. This helps to guard against situations where malicious code attempts to pass an infinite stream of bytes to the method.