Class MemberService

Represents the MemberService.

Inheritance

System.Object

RepositoryService

Namespace: Umbraco.Cms.Core.Services.Implement

Assembly: cs.temp.dll.dll

Syntax

public class MemberService : RepositoryService

Constructors

MemberService(IScopeProvider, ILoggerFactory, IEventMessagesFactory, IMemberGroupService, IMemberRepository, IMemberTypeRepository, IMemberGroupRepository, IAuditRepository)

Declaration

public MemberService(IScopeProvider provider, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IMemberGroupService memberGroupService, IMemberRepository memberRepository, IMemberTypeRepository memberTypeRepository, IMemberGroupRepository memberGroupRepository, IAuditRepository auditRepository)

Parameters

Type	Name	Description
IScopeProvider	provider
ILoggerFactory	loggerFactory
IEventMessagesFactory	eventMessagesFactory
IMemberGroupService	memberGroupService
IMemberRepository	memberRepository
IMemberTypeRepository	memberTypeRepository
IMemberGroupRepository	memberGroupRepository
IAuditRepository	auditRepository

Methods

AddRole(String)

Declaration

public void AddRole(string roleName)

Parameters

Type	Name	Description
System.String	roleName

AssignRole(Int32, String)

Declaration

public void AssignRole(int memberId, string roleName)

Parameters

Type	Name	Description
System.Int32	memberId
System.String	roleName

AssignRole(String, String)

Declaration

public void AssignRole(string username, string roleName)

Parameters

Type	Name	Description
System.String	username
System.String	roleName

AssignRoles(Int32[], String[])

Declaration

public void AssignRoles(int[] memberIds, string[] roleNames)

Parameters

Type	Name	Description
System.Int32[]	memberIds
System.String[]	roleNames

AssignRoles(String[], String[])

Declaration

public void AssignRoles(string[] usernames, string[] roleNames)

Parameters

Type	Name	Description
System.String[]	usernames
System.String[]	roleNames

Count(String)

Gets the count of Members by an optional MemberType alias

Declaration

public int Count(string memberTypeAlias = null)

Parameters

Type	Name	Description
System.String	memberTypeAlias	Optional alias for the MemberType when counting number of Members

Returns

Type	Description
System.Int32	with number of Members

Remarks

If no alias is supplied then the count for all Member will be returned

CreateMember(String, String, String, IMemberType)

Creates an object without persisting it

Declaration

public IMember CreateMember(string username, string email, string name, IMemberType memberType)

Parameters

Type	Name	Description
System.String	username	Username of the Member to create
System.String	email	Email of the Member to create
System.String	name	Name of the Member to create
IMemberType	memberType	MemberType the Member should be based on

Returns

Type	Description
IMember

Remarks

This method is convenient for when you need to add properties to a new Member before persisting it in order to limit the amount of times its saved. Also note that the returned will not have an Id until its saved.

CreateMember(String, String, String, String)

Creates an object without persisting it

Declaration

public IMember CreateMember(string username, string email, string name, string memberTypeAlias)

Parameters

Type	Name	Description
System.String	username	Username of the Member to create
System.String	email	Email of the Member to create
System.String	name	Name of the Member to create
System.String	memberTypeAlias	Alias of the MemberType the Member should be based on

Returns

Type	Description
IMember

Remarks

This method is convenient for when you need to add properties to a new Member before persisting it in order to limit the amount of times its saved. Also note that the returned will not have an Id until its saved.

Exceptions

Type	Condition
System.ArgumentException	Thrown when a member type for the given alias isn't found

CreateMemberWithIdentity(String, String, IMemberType)

Declaration

public IMember CreateMemberWithIdentity(string username, string email, IMemberType memberType)

Parameters

Type	Name	Description
System.String	username
System.String	email
IMemberType	memberType

Returns

Type	Description
IMember

CreateMemberWithIdentity(String, String, IMemberType, Boolean)

Creates and persists a Member

Declaration

public IMember CreateMemberWithIdentity(string username, string email, IMemberType memberType, bool isApproved)

Parameters

Type	Name	Description
System.String	username	Username of the Member to create
System.String	email	Email of the Member to create
IMemberType	memberType	MemberType the Member should be based on
System.Boolean	isApproved

Returns

Type	Description
IMember

Remarks

Using this method will persist the Member object before its returned meaning that it will have an Id available (unlike the CreateMember method)

CreateMemberWithIdentity(String, String, String)

Declaration

public IMember CreateMemberWithIdentity(string username, string email, string memberTypeAlias)

Parameters

Type	Name	Description
System.String	username
System.String	email
System.String	memberTypeAlias

Returns

Type	Description
IMember

CreateMemberWithIdentity(String, String, String, IMemberType)

Declaration

public IMember CreateMemberWithIdentity(string username, string email, string name, IMemberType memberType)

Parameters

Type	Name	Description
System.String	username
System.String	email
System.String	name
IMemberType	memberType

Returns

Type	Description
IMember

CreateMemberWithIdentity(String, String, String, IMemberType, Boolean)

Creates and persists a Member

Declaration

public IMember CreateMemberWithIdentity(string username, string email, string name, IMemberType memberType, bool isApproved)

Parameters

Type	Name	Description
System.String	username	Username of the Member to create
System.String	email	Email of the Member to create
System.String	name	Name of the Member to create
IMemberType	memberType	MemberType the Member should be based on
System.Boolean	isApproved

Returns

Type	Description
IMember

Remarks

Using this method will persist the Member object before its returned meaning that it will have an Id available (unlike the CreateMember method)

CreateMemberWithIdentity(String, String, String, Boolean)

Declaration

public IMember CreateMemberWithIdentity(string username, string email, string memberTypeAlias, bool isApproved)

Parameters

Type	Name	Description
System.String	username
System.String	email
System.String	memberTypeAlias
System.Boolean	isApproved

Returns

Type	Description
IMember

CreateMemberWithIdentity(String, String, String, String)

Declaration

public IMember CreateMemberWithIdentity(string username, string email, string name, string memberTypeAlias)

Parameters

Type	Name	Description
System.String	username
System.String	email
System.String	name
System.String	memberTypeAlias

Returns

Type	Description
IMember

CreateMemberWithIdentity(String, String, String, String, Boolean)

Declaration

public IMember CreateMemberWithIdentity(string username, string email, string name, string memberTypeAlias, bool isApproved)

Parameters

Type	Name	Description
System.String	username
System.String	email
System.String	name
System.String	memberTypeAlias
System.Boolean	isApproved

Returns

Type	Description
IMember

CreateMemberWithIdentity(String, String, String, String, String, Boolean)

Creates and persists a Member

Declaration

public IMember CreateMemberWithIdentity(string username, string email, string name, string passwordValue, string memberTypeAlias, bool isApproved = true)

Parameters

Type	Name	Description
System.String	username	Username of the Member to create
System.String	email	Email of the Member to create
System.String	name	Name of the Member to create
System.String	passwordValue
System.String	memberTypeAlias	Alias of the MemberType the Member should be based on
System.Boolean	isApproved	Optional IsApproved of the Member to create

Returns

Type	Description
IMember

Remarks

Using this method will persist the Member object before its returned meaning that it will have an Id available (unlike the CreateMember method)

Delete(IMember)

Deletes an

Declaration

public void Delete(IMember member)

Parameters

Type	Name	Description
IMember	member	to Delete

DeleteMembersOfType(Int32)

Delete Members of the specified MemberType id

Declaration

public void DeleteMembersOfType(int memberTypeId)

Parameters

Type	Name	Description
System.Int32	memberTypeId	Id of the MemberType

DeleteRole(String, Boolean)

Declaration

public bool DeleteRole(string roleName, bool throwIfBeingUsed)

Parameters

Type	Name	Description
System.String	roleName
System.Boolean	throwIfBeingUsed

Returns

Type	Description
System.Boolean

DissociateRole(Int32, String)

Declaration

public void DissociateRole(int memberId, string roleName)

Parameters

Type	Name	Description
System.Int32	memberId
System.String	roleName

DissociateRole(String, String)

Declaration

public void DissociateRole(string username, string roleName)

Parameters

Type	Name	Description
System.String	username
System.String	roleName

DissociateRoles(Int32[], String[])

Declaration

public void DissociateRoles(int[] memberIds, string[] roleNames)

Parameters

Type	Name	Description
System.Int32[]	memberIds
System.String[]	roleNames

DissociateRoles(String[], String[])

Declaration

public void DissociateRoles(string[] usernames, string[] roleNames)

Parameters

Type	Name	Description
System.String[]	usernames
System.String[]	roleNames

Exists(Int32)

Checks if a Member with the id exists

Declaration

public bool Exists(int id)

Parameters

Type	Name	Description
System.Int32	id	Id of the Member

Returns

Type	Description
System.Boolean	True if the Member exists otherwise False

Exists(String)

Checks if a Member with the username exists

Declaration

public bool Exists(string username)

Parameters

Type	Name	Description
System.String	username	Username to check

Returns

Type	Description
System.Boolean	True if the Member exists otherwise False

ExportMember(Guid)

Exports a member.

Declaration

public MemberExportModel ExportMember(Guid key)

Parameters

Type	Name	Description
System.Guid	key

Returns

Type	Description
MemberExportModel

Remarks

This is internal for now and is used to export a member in the member editor, it will raise an event so that auditing logs can be created.

FindByEmail(String, Int64, Int32, out Int64, StringPropertyMatchType)

Finds a list of objects by a partial email string

Declaration

public IEnumerable<IMember> FindByEmail(string emailStringToMatch, long pageIndex, int pageSize, out long totalRecords, StringPropertyMatchType matchType = null)

Parameters

Type	Name	Description
System.String	emailStringToMatch	Partial email string to match
System.Int64	pageIndex	Current page index
System.Int32	pageSize	Size of the page
System.Int64	totalRecords	Total number of records found (out)
StringPropertyMatchType	matchType	The type of match to make as . Default is

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

FindByUsername(String, Int64, Int32, out Int64, StringPropertyMatchType)

Finds a list of objects by a partial username

Declaration

public IEnumerable<IMember> FindByUsername(string login, long pageIndex, int pageSize, out long totalRecords, StringPropertyMatchType matchType = null)

Parameters

Type	Name	Description
System.String	login	Partial username to match
System.Int64	pageIndex	Current page index
System.Int32	pageSize	Size of the page
System.Int64	totalRecords	Total number of records found (out)
StringPropertyMatchType	matchType	The type of match to make as . Default is

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

FindMembersByDisplayName(String, Int64, Int32, out Int64, StringPropertyMatchType)

Finds Members based on their display name

Declaration

public IEnumerable<IMember> FindMembersByDisplayName(string displayNameToMatch, long pageIndex, int pageSize, out long totalRecords, StringPropertyMatchType matchType = null)

Parameters

Type	Name	Description
System.String	displayNameToMatch	Display name to match
System.Int64	pageIndex	Current page index
System.Int32	pageSize	Size of the page
System.Int64	totalRecords	Total number of records found (out)
StringPropertyMatchType	matchType	The type of match to make as . Default is

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

FindMembersInRole(String, String, StringPropertyMatchType)

Declaration

public IEnumerable<IMember> FindMembersInRole(string roleName, string usernameToMatch, StringPropertyMatchType matchType = null)

Parameters

Type	Name	Description
System.String	roleName
System.String	usernameToMatch
StringPropertyMatchType	matchType

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>

GetAll(Int64, Int32, out Int64)

Gets a list of paged objects

Declaration

public IEnumerable<IMember> GetAll(long pageIndex, int pageSize, out long totalRecords)

Parameters

Type	Name	Description
System.Int64	pageIndex	Current page index
System.Int32	pageSize	Size of the page
System.Int64	totalRecords	Total number of records found (out)

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetAll(Int64, Int32, out Int64, String, Direction, Boolean, String, String)

Declaration

public IEnumerable<IMember> GetAll(long pageIndex, int pageSize, out long totalRecords, string orderBy, Direction orderDirection, bool orderBySystemField, string memberTypeAlias, string filter)

Parameters

Type	Name	Description
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
System.String	orderBy
Direction	orderDirection
System.Boolean	orderBySystemField
System.String	memberTypeAlias
System.String	filter

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>

GetAll(Int64, Int32, out Int64, String, Direction, String, String)

Declaration

public IEnumerable<IMember> GetAll(long pageIndex, int pageSize, out long totalRecords, string orderBy, Direction orderDirection, string memberTypeAlias = null, string filter = "")

Parameters

Type	Name	Description
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
System.String	orderBy
Direction	orderDirection
System.String	memberTypeAlias
System.String	filter

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>

GetAllMembers(Int32[])

Gets all Members with the ids specified

Declaration

public IEnumerable<IMember> GetAllMembers(params int[] ids)

Parameters

Type	Name	Description
System.Int32[]	ids	Optional list of Member Ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

Remarks

If no Ids are specified all Members will be retrieved

GetAllRoles()

Returns a list of all member roles

Declaration

public IEnumerable<IMemberGroup> GetAllRoles()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMemberGroup>	A list of member roles

GetAllRoles(Int32)

Returns a list of all member roles for a given member ID

Declaration

public IEnumerable<string> GetAllRoles(int memberId)

Parameters

Type	Name	Description
System.Int32	memberId

Returns

Type	Description
System.Collections.Generic.IEnumerable<System.String>	A list of member roles

GetAllRoles(String)

Declaration

public IEnumerable<string> GetAllRoles(string username)

Parameters

Type	Name	Description
System.String	username

Returns

Type	Description
System.Collections.Generic.IEnumerable<System.String>

GetAllRolesIds()

Declaration

public IEnumerable<int> GetAllRolesIds()

Returns

Type	Description
System.Collections.Generic.IEnumerable<System.Int32>

GetAllRolesIds(Int32)

Declaration

public IEnumerable<int> GetAllRolesIds(int memberId)

Parameters

Type	Name	Description
System.Int32	memberId

Returns

Type	Description
System.Collections.Generic.IEnumerable<System.Int32>

GetAllRolesIds(String)

Declaration

public IEnumerable<int> GetAllRolesIds(string username)

Parameters

Type	Name	Description
System.String	username

Returns

Type	Description
System.Collections.Generic.IEnumerable<System.Int32>

GetByEmail(String)

Get an by email

Declaration

public IMember GetByEmail(string email)

Parameters

Type	Name	Description
System.String	email	Email to use for retrieval

Returns

Type	Description
IMember

GetById(Int32)

Gets a Member by its integer id

Declaration

public IMember GetById(int id)

Parameters

Type	Name	Description
System.Int32	id	Id

Returns

Type	Description
IMember

GetByKey(Guid)

Gets a Member by the unique key

Declaration

public IMember GetByKey(Guid id)

Parameters

Type	Name	Description
System.Guid	id	System.Guid Id

Returns

Type	Description
IMember

Remarks

The guid key corresponds to the unique id in the database and the user id in the membership provider.

GetByProviderKey(Object)

Gets an by its provider key

Declaration

public IMember GetByProviderKey(object id)

Parameters

Type	Name	Description
System.Object	id	Id to use for retrieval

Returns

Type	Description
IMember

GetByUsername(String)

Get an by username

Declaration

public IMember GetByUsername(string username)

Parameters

Type	Name	Description
System.String	username	Username to use for retrieval

Returns

Type	Description
IMember

GetCount(MemberCountType)

Gets the total number of Members based on the count type

Declaration

public int GetCount(MemberCountType countType)

Parameters

Type	Name	Description
MemberCountType	countType	to count by

Returns

Type	Description
System.Int32	with number of Members for passed in type

Remarks

The way the Online count is done is the same way that it is done in the MS SqlMembershipProvider - We query for any members that have their last active date within the Membership.UserIsOnlineTimeWindow (which is in minutes). It isn't exact science but that is how MS have made theirs so we'll follow that principal.

GetMembersByGroup(String)

Gets all Members within the specified MemberGroup name

Declaration

public IEnumerable<IMember> GetMembersByGroup(string memberGroupName)

Parameters

Type	Name	Description
System.String	memberGroupName	Name of the MemberGroup

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetMembersByMemberType(Int32)

Gets all Members for the MemberType id

Declaration

public IEnumerable<IMember> GetMembersByMemberType(int memberTypeId)

Parameters

Type	Name	Description
System.Int32	memberTypeId	Id of the MemberType

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetMembersByMemberType(String)

Gets all Members for the specified MemberType alias

Declaration

public IEnumerable<IMember> GetMembersByMemberType(string memberTypeAlias)

Parameters

Type	Name	Description
System.String	memberTypeAlias	Alias of the MemberType

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetMembersByPropertyValue(String, Boolean)

Gets a list of Members based on a property search

Declaration

public IEnumerable<IMember> GetMembersByPropertyValue(string propertyTypeAlias, bool value)

Parameters

Type	Name	Description
System.String	propertyTypeAlias	Alias of the PropertyType to search for
System.Boolean	value	Value to match

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetMembersByPropertyValue(String, DateTime, ValuePropertyMatchType)

Gets a list of Members based on a property search

Declaration

public IEnumerable<IMember> GetMembersByPropertyValue(string propertyTypeAlias, DateTime value, ValuePropertyMatchType matchType = null)

Parameters

Type	Name	Description
System.String	propertyTypeAlias	Alias of the PropertyType to search for
System.DateTime	value	System.DateTime Value to match
ValuePropertyMatchType	matchType	The type of match to make as . Default is

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetMembersByPropertyValue(String, Int32, ValuePropertyMatchType)

Gets a list of Members based on a property search

Declaration

public IEnumerable<IMember> GetMembersByPropertyValue(string propertyTypeAlias, int value, ValuePropertyMatchType matchType = null)

Parameters

Type	Name	Description
System.String	propertyTypeAlias	Alias of the PropertyType to search for
System.Int32	value	Value to match
ValuePropertyMatchType	matchType	The type of match to make as . Default is

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetMembersByPropertyValue(String, String, StringPropertyMatchType)

Gets a list of Members based on a property search

Declaration

public IEnumerable<IMember> GetMembersByPropertyValue(string propertyTypeAlias, string value, StringPropertyMatchType matchType = null)

Parameters

Type	Name	Description
System.String	propertyTypeAlias	Alias of the PropertyType to search for
System.String	value	Value to match
StringPropertyMatchType	matchType	The type of match to make as . Default is

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>	System.Collections.Generic.IEnumerable<T>

GetMembersInRole(String)

Declaration

public IEnumerable<IMember> GetMembersInRole(string roleName)

Parameters

Type	Name	Description
System.String	roleName

Returns

Type	Description
System.Collections.Generic.IEnumerable<IMember>

ReplaceRoles(Int32[], String[])

Declaration

public void ReplaceRoles(int[] memberIds, string[] roleNames)

Parameters

Type	Name	Description
System.Int32[]	memberIds
System.String[]	roleNames

ReplaceRoles(String[], String[])

Declaration

public void ReplaceRoles(string[] usernames, string[] roleNames)

Parameters

Type	Name	Description
System.String[]	usernames
System.String[]	roleNames

Save(IMember)

Declaration

public void Save(IMember member)

Parameters

Type	Name	Description
IMember	member

Save(IEnumerable<IMember>)

Declaration

public void Save(IEnumerable<IMember> members)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<IMember>	members

SetLastLogin(String, DateTime)

Declaration

public void SetLastLogin(string username, DateTime date)

Parameters

Type	Name	Description
System.String	username
System.DateTime	date