ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得 Active Directory 資料存放區中儲存之所有使用者的集合。
public:
override System::Web::Security::MembershipUserCollection ^ GetAllUsers(int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public override System.Web.Security.MembershipUserCollection GetAllUsers (int pageIndex, int pageSize, out int totalRecords);
override this.GetAllUsers : int * int * int -> System.Web.Security.MembershipUserCollection
Public Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection
參數
- pageIndex
- Int32
要傳回的結果網頁索引。 pageIndex
以零為起始。
- pageSize
- Int32
要傳回的結果網頁大小。
- totalRecords
- Int32
這個方法返回時,會包含集合中傳回的資料錄總數。 這個參數會以未初始化的狀態傳遞。
傳回
MembershipUserCollection,包含 pageSize
MembershipUser 執行個體,從 pageIndex
指定的頁面開始。
例外狀況
GetAllUsers(Int32, Int32, Int32) 方法的呼叫,會在初始化 ActiveDirectoryMembershipProvider 執行個體之前進行。
EnableSearchMethods 屬性為 false
。
備註
類別會呼叫 Membership 這個方法,從 ASP.NET 應用程式組態檔中指定的 Active Directory 資料存放區擷取使用者資訊。
方法傳 GetAllUsers 回的結果會受到 pageIndex
和 pageSize
參數的限制。 參數 pageSize
會指定要在集合中 MembershipUserCollection 傳回的 MembershipUser 實例數目上限。 參數 pageIndex
會指定要傳回的結果頁面,其中 0 (零) 表示第一頁。
參數 totalRecords
是一個 out
參數,設定為 Active Directory 資料存放區中找到的相符成員資格使用者總數。 例如,如果已設定的資料存放區有 13 個使用者,且 pageIndex
值為 1 且 la pageSize
為 5,則 MembershipUserCollection 傳回的 會包含第六到第十個使用者。 參數 totalRecords
會設定為 13。
您可以使用成員資格元素的 屬性, (ASP.NET Settings Schema) 元素的 屬性,來控制 EnableSearchMethodsenableSearchMethods
是否允許搜尋使用者。 EnableSearchMethods將 屬性設定為 false
會導致 GetAllUsers 方法擲回例外狀況 NotSupportedException 。
提供者會使用從連接字串中指定的搜尋點開始的子樹搜尋。 ActiveDirectoryMembershipProvider如需連接字串的詳細資訊,請參閱 類別主題。
建議您在確認 類別發出的 ActiveDirectoryMembershipProvider 搜尋查詢不會對目錄伺服器的效能造成負面影響之前,才啟用在生產系統上搜尋。 由於 類別 ActiveDirectoryMembershipProvider 是針對無狀態 Web 環境所設計,因此無法使用基礎 System.DirectoryServices API 所公開的分頁優化。 這表示在搜尋大型目錄期間的分頁作業非常昂貴,因此應該避免。 搜尋作業一律會針對連接字串中設定的目錄伺服器發出,或在指向網域的連接字串的情況下自動選取的伺服器發出。 提供者不會針對其搜尋方法使用通用類別目錄。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應