FileAuthorizationModule.CheckFileAccessForUser(String, IntPtr, String) 方法

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

判斷使用者是否有權限可存取所要求的檔案。

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

參數

virtualPath

String

檔案的虛擬路徑。

token

IntPtr

nativeint

表示使用者的 Windows 存取語彙基元 (Token)。

verb

String

用來提出要求的 HTTP 動詞命令。

傳回

Boolean

如果以 token 表示的目前 Windows 使用者可以使用指定的 HTTP 動詞命令存取檔案，或是如果應用程式的組態檔中未定義 FileAuthorizationModule 模組，則為 true，否則為 false。

例外狀況

ArgumentNullException

virtualPath 為 null。

-或-

token 為 Zero。

-或-

verb 為 null。

ArgumentException

virtualPath 不在 Web 應用程式的應用程式目錄結構中。

FileNotFoundException

由 virtualPath 指定的檔案不存在。

備註

方法 CheckFileAccessForUser 會檢查目前使用者是否以 Windows 存取權杖表示，在檔系統存取控制清單中授與要求的檔案存取權， (ACL) 。 虛擬路徑會先對應到實體檔案系統路徑，再進行檢查。

如果用來提出要求的 HTTP 動詞命令為 GET 、 POST 或 HEAD ，則 方法會 CheckFileAccessForUser 檢查檔案的讀取權限。 如果使用任何其他動詞，方法會 CheckFileAccessForUser 檢查檔案的讀取/寫入權限。

安全性注意事項FileAuthorizationModule如果模組未定義于 httpModules 應用程式的組態區段中，模組一 FileAuthorizationModule 律會傳 true 回 。