Initialize 方法

輸入提供者的名稱和組態設定的 NameValueCollection。用以設定提供者執行個體的屬性值，包括實作特定值以及組態檔 (Machine.config 或 Web.config) 中指定的選項。

ApplicationName 屬性

應用程式的名稱，使用組態檔 (Web.config) 中所指定的角色資訊。ApplicationName 會搭配相關使用者資訊存放在資料來源中，用以查詢使用者資訊。請參閱本主題稍後的 ApplicationName 章節，以獲取詳細資訊。

如果沒有明確指定的話，這個屬性是讀寫並且預設值為 ApplicationPath。

AddUsersToRoles 方法

輸入使用者名稱和角色名稱的清單，並且在已設定 ApplicationName 的資料來源中，將這些清單以指定的角色與指定的使用者產生關聯。

如果已設定 ApplicationName 的任何指定角色名稱或使用者名稱不存在，您應該擲回 ProviderException。

如果任何指定的使用者名稱或角色名稱是空白字串，就應該擲回 ArgumentException；如果任何指定的使用者名稱或角色名稱是 null (在 Visual Basic 中是 Nothing)，就應該擲回 ArgumentNullException。

如果資料來源支援交易，您應該在交易中包含每個加入作業；如果任何加入作業失敗，就復原交易或擲回例外狀況。

CreateRole 方法

輸入角色名稱，並且將已設定 ApplicationName 的指定角色加入資料來源。

如果已設定 ApplicationName 的指定角色名稱已存在，就應該擲回 ProviderException。

如果指定的角色名稱是空白字串、包含逗號或超過資料來源允許的最大長度，就應該擲回 ArgumentException；如果指定的角色名稱是 null (在 Visual Basic 中是 Nothing)，就應該擲回 ArgumentNullException。

DeleteRole 方法

輸入角色名稱，以及表示如果仍然有使用者與角色相關聯時，是否要擲回例外狀況的布林值 (Boolean)。DeleteRole 會從已設定 ApplicationName 的資料來源中刪除指定角色。

如果 throwOnPopulatedRole 參數是 true，並且角色名稱參數識別的角色有一或多個成員，就擲回 ProviderException 並且不刪除角色。如果 throwOnPopulatedRole 參數是 false，不論角色是否為空白都將之刪除。

當您從資料來源刪除角色時，請確定同時刪除使用者名稱與設定 ApplicationName 之已刪除角色間的任何關聯。

如果指定的角色名稱不存在或是空白字串，您應該擲回 ArgumentException。如果指定的角色名稱是 null (在 Visual Basic 中是 Nothing)，您應該擲回 ArgumentNullException。

FindUsersInRole 方法

輸入要搜尋的角色名稱和使用者名稱，然後傳回角色中的使用者清單，其中使用者名稱符合已設定 ApplicationName 提供的 usernameToMatch。萬用字元的支援，根據資料來源特性所提供。使用者是以使用者名稱字母順序傳回。

如果資料來源中不存在指定的角色名稱，建議您擲回 ProviderException。

GetAllRoles 方法

從資料來源傳回角色名稱清單。只會擷取指定 ApplicationName 的角色。

如果已設定 ApplicationName 的角色不存在，您應該傳回沒有項目的字串陣列。

GetRolesForUser 方法

輸入使用者名稱，然後從資料來源傳回與指定使用者相關聯的角色名稱。只會擷取設定 ApplicationName 的角色。

如果已設定 ApplicationName 的指定使用者角色不存在，您應該傳回沒有項目的字串陣列。

如果指定的使用者名稱是空白字串，您應該擲回 ArgumentException。如果指定的使用者名稱是 null (在 Visual Basic 中是 Nothing)，您應該擲回 ArgumentNullException。

GetUsersInRole 方法

輸入角色名稱，然後從資料來源傳回與角色相關聯的使用者名稱。只會擷取設定 ApplicationName 的角色。

如果已設定 ApplicationName 的指定角色名稱不存在，您應該擲回 ProviderException。

如果沒有使用者與已設定 ApplicationName 之指定角色相關聯，您應該傳回沒有項目的字串陣列。

如果指定的角色名稱是空白字串、包含逗號、或超過資料來源允許的角色名稱最大長度，就應該擲回 ArgumentException。如果指定的角色名稱是 null (在 Visual Basic 中是 Nothing)，您應該擲回 ArgumentNullException。

IsUserInRole 方法

輸入使用者名稱和角色名稱，並且判斷目前登入的使用者是否與設定 ApplicationName 的資料來源角色相關聯。

如果已設定 ApplicationName 的指定角色名稱或使用者名稱不存在，您應該擲回 ProviderException。

如果指定的使用者名稱或角色名稱是空白字串，就應該擲回 ArgumentException；如果指定的使用者名稱或角色名稱是 null (在 Visual Basic 中是 Nothing)，就應該擲回 ArgumentNullException。

RemoveUsersFromRoles 方法

輸入使用者名稱和角色名稱的清單，並且在已設定 ApplicationName 的資料來源中，從指定角色移除指定使用者的關聯。

如果已設定 ApplicationName 的任何指定角色名稱或使用者名稱不存在，您應該擲回 ProviderException。

如果任何指定的使用者名稱或角色名稱是空白字串，就應該擲回 ArgumentException；如果任何指定的使用者名稱或角色名稱是 null (在 Visual Basic 中是 Nothing)，就應該擲回 ArgumentNullException。

如果資料來源支援交易，您應該在交易中包含每個移除作業；如果任何移除作業失敗，就復原交易或擲回例外狀況。

RoleExists 方法

輸入角色名稱，並且判斷已設定 ApplicationName 的資料來源中是否存在此角色名稱。

如果指定的角色名稱不存在或是空白字串，您應該擲回 ArgumentException。如果指定的角色名稱是 null (在 Visual Basic 中是 Nothing)，建議您擲回 ArgumentNullException。