FileAuthorizationModule.CheckFileAccessForUser(String, IntPtr, String) Methode

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Bestimmt, ob dem Benutzer Zugriff auf die angeforderte Datei gewährt wird.

public:
 static bool CheckFileAccessForUser(System::String ^ virtualPath, IntPtr token, System::String ^ verb);

public static bool CheckFileAccessForUser (string virtualPath, IntPtr token, string verb);

static member CheckFileAccessForUser : string * nativeint * string -> bool

Public Shared Function CheckFileAccessForUser (virtualPath As String, token As IntPtr, verb As String) As Boolean

Parameter

virtualPath

String

Der virtuelle Pfad zur Datei.

token

IntPtr

nativeint

Ein Windows-Zugriffstoken, das den Benutzer darstellt.

verb

String

Das HTTP-Verb, das für die Anforderung verwendet wird.

Gibt zurück

Boolean

true, wenn der aktuelle, durch token dargestellte Windows-Benutzer mithilfe des angegebenen HTTP-Verbs Zugriff auf die Datei hat oder wenn das FileAuthorizationModule-Modul in der Konfigurationsdatei der Anwendung nicht definiert ist, andernfalls false.

Ausnahmen

ArgumentNullException

virtualPath ist null.

- oder -

token ist Zero.

- oder -

verb ist null.

ArgumentException

virtualPath befindet sich nicht in der Anwendungsverzeichnisstruktur der Webanwendung.

FileNotFoundException

Die Datei, die unter virtualPath angegeben ist, ist nicht vorhanden.

Hinweise

Die CheckFileAccessForUser -Methode überprüft, ob dem aktuellen Benutzer, dargestellt durch ein Windows-Zugriffstoken, Zugriff auf die angeforderte Datei in den Zugriffssteuerungslisten (Access Control Lists, ACLs) des Dateisystems gewährt wird. Der virtuelle Pfad wird dem physischen Dateisystempfad zugeordnet, bevor die Überprüfung durchgeführt wird.

Wenn das für die Anforderung verwendete HTTP-Verb , oder lautetGET, überprüft die CheckFileAccessForUser Methode auf Lesezugriff auf die HEADDatei. POST Wenn ein anderes Verb verwendet wird, überprüft die CheckFileAccessForUser -Methode auf Lese-/Schreibberechtigungen für die Datei.

Sicherheitshinweis Wenn das FileAuthorizationModule Modul nicht im httpModules Konfigurationsabschnitt für die Anwendung definiert ist, gibt das FileAuthorizationModule Modul immer zurück true.