XmlResolver.GetEntity-Methode

Weist beim Überschreiben in einer abgeleiteten Klasse einen URI einem Objekt zu, das die eigentliche Ressource enthält.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public MustOverride Function GetEntity ( _
    absoluteUri As Uri, _
    role As String, _
    ofObjectToReturn As Type _
) As Object
'Usage
Dim instance As XmlResolver
Dim absoluteUri As Uri
Dim role As String
Dim ofObjectToReturn As Type
Dim returnValue As Object

returnValue = instance.GetEntity(absoluteUri, role, ofObjectToReturn)

public abstract Object GetEntity (
    Uri absoluteUri,
    string role,
    Type ofObjectToReturn
)

public:
virtual Object^ GetEntity (
    Uri^ absoluteUri, 
    String^ role, 
    Type^ ofObjectToReturn
) abstract

public abstract Object GetEntity (
    Uri absoluteUri, 
    String role, 
    Type ofObjectToReturn
)

public abstract function GetEntity (
    absoluteUri : Uri, 
    role : String, 
    ofObjectToReturn : Type
) : Object

Parameter

• absoluteUri
  Der von ResolveUri zurückgegebene URI.

• role
  In der aktuellen Version wird dieser Parameter beim Auflösen von URIs nicht verwendet. Er wird für die spätere Erweiterbarkeit bereitgestellt. Er kann z. B. xlink:role zugeordnet und als implementierungsspezifisches Argument in anderen Szenarios verwendet werden.

• ofObjectToReturn
  Der Typ des zurückzugebenden Objekts. Die aktuelle Version gibt nur System.IO.Stream-Objekte zurück.

Rückgabewert

Ein System.IO.Stream-Objekt oder NULL (Nothing in Visual Basic), wenn ein anderer Typ als Stream angegeben ist.

Ausnahmen

Ausnahmetyp	Bedingung
XmlException	ofObjectToReturn ist weder NULL (Nothing in Visual Basic) noch vom Typ Stream.
UriFormatException	Der angegebene URI ist kein absoluter URI.
NullReferenceException	absoluteUri ist NULL (Nothing in Visual Basic).
Exception	Es ist ein Laufzeitfehler aufgetreten (z. B. eine unterbrochene Serververbindung).

Hinweise

Diese Methode wird verwendet, wenn der Aufrufer einen angegebenen URI dem Objekt zuweisen möchte, das die vom URI dargestellte Ressource enthält. Der zurückgegebene Objekttyp kann ausgehandelt werden, die Implementierung muss jedoch immer System.IO.Stream unterstützen.

Sicherheitshinweis
In der Anwendung kann die Gefahr von Denial-of-Service-Angriffen für die GetEntity-Methode im Arbeitsspeicher verringert werden, indem Sie einen als Wrapper implementierten IStream implementieren, der die Anzahl von gelesenen Bytes beschränkt. Dies hilft dabei, Situationen abzuwenden, in denen böswilliger Code versucht, einen unendlichen Stream von Bytes an die GetEntity-Methode zu übergeben.

Beispiel

Ein Beispiel für die Verwendung dieser Methode finden Sie unter XmlUrlResolver.GetEntity.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlResolver-Klasse
XmlResolver-Member
System.Xml-Namespace

Weitere Ressourcen

Sicherheit und System.Xml-Anwendungen