XmlSecureResolver.GetEntity-Methode

Ordnet einem Objekt, das die eigentliche Ressource enthält, sicher einen URI zu. Diese Methode legt temporär das im Konstruktor durch Aufruf von PermissionSet.PermitOnly erstellte System.Security.PermissionSet fest, bevor GetEntity für den zugrunde liegenden XmlResolver zum Öffnen der Ressource aufgerufen wird.

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

Syntax

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

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

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

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

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

public override 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 Stream-Objekte zurück.

Rückgabewert

Ein durch Aufruf von GetEntity für den zugrunde liegenden XmlResolver zurückgegebenes Stream-Objekt. Wenn ein anderer Typ als Stream angegeben ist, wird NULL (Nothing in Visual Basic) zurückgegeben.

Ausnahmen

Hinweise

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.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

XmlSecureResolver-Klasse
XmlSecureResolver-Member
System.Xml-Namespace

Weitere Ressourcen

Sicherheit und System.Xml-Anwendungen