View Source

Interface IMemberService

Defines the MemberService, which is an easy access to operations involving (umbraco) members.

Namespace: Umbraco.Cms.Core.Services
Assembly: Umbraco.Core.dll
Syntax
public interface IMemberService : IMembershipMemberService, IMembershipMemberService<IMember>, IService, IMembershipRoleService<IMember>

Methods

View Source

Count(String)

Gets the count of Members by an optional MemberType alias

Declaration
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

System.Int32 with number of Members
Remarks

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

View Source

CreateMember(String, String, String, String)

Creates an IMember object without persisting it

Declaration
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 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 IMember will not have an Id until its saved.

View Source

CreateMember(String, String, String, IMemberType)

Creates an IMember object without persisting it

Declaration
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 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 IMember will not have an Id until its saved.

View Source

CreateMemberWithIdentity(String, String, String)

Creates and persists a Member

Declaration
virtual IMember CreateMemberWithIdentity(string username, string email, 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 memberTypeAlias

Alias of the MemberType the Member should be based on
Returns
Type Description
IMember 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)

View Source

CreateMemberWithIdentity(String, String, String, Boolean)

Creates and persists a Member

Declaration
virtual IMember CreateMemberWithIdentity(string username, string email, string memberTypeAlias, 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 memberTypeAlias

Alias of the MemberType the Member should be based on
System.Boolean isApproved

Whether the member is approved or not
Returns
Type Description
IMember 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)

View Source

CreateMemberWithIdentity(String, String, String, String)

Creates and persists a Member

Declaration
IMember CreateMemberWithIdentity(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 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)

View Source

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

Creates and persists a Member

Declaration
virtual IMember CreateMemberWithIdentity(string username, string email, string name, string memberTypeAlias, 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
System.String memberTypeAlias

Alias of the MemberType the Member should be based on
System.Boolean isApproved

Whether the member is approved or not
Returns
Type Description
IMember 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)

View Source

CreateMemberWithIdentity(String, String, String, IMemberType)

Creates and persists a Member

Declaration
IMember CreateMemberWithIdentity(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 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)

View Source

DeleteMembersOfType(Int32)

Delete Members of the specified MemberType id

Declaration
void DeleteMembersOfType(int memberTypeId)
Parameters
Type Name Description
System.Int32 memberTypeId

Id of the MemberType
View Source

Exists(Int32)

Checks if a Member with the id exists

Declaration
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
View Source

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

Finds Members based on their display name

Declaration
IEnumerable<IMember> FindMembersByDisplayName(string displayNameToMatch, long pageIndex, int pageSize, out long totalRecords, StringPropertyMatchType matchType = StringPropertyMatchType.StartsWith)
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 StringPropertyMatchType. Default is StartsWith
Returns
Type Description
IEnumerable<IMember>
View Source

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

Gets a list of paged IMember objects

Declaration
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

Current page index
System.Int32 pageSize

Size of the page
System.Int64 totalRecords

Total number of records found (out)
System.String orderBy

Field to order by
Direction orderDirection

Direction to order by
System.Boolean orderBySystemField

Flag to indicate when ordering by system field
System.String memberTypeAlias
System.String filter

Search text filter
Returns
Type Description
IEnumerable<IMember>
Remarks

An IMember can be of type IMember

View Source

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

Gets a list of paged IMember objects

Declaration
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

Current page index
System.Int32 pageSize

Size of the page
System.Int64 totalRecords

Total number of records found (out)
System.String orderBy

Field to order by
Direction orderDirection

Direction to order by
System.String memberTypeAlias
System.String filter

Search text filter
Returns
Type Description
IEnumerable<IMember>
Remarks

An IMember can be of type IMember

View Source

GetAllMembers(Int32[])

Gets all Members with the ids specified

Declaration
IEnumerable<IMember> GetAllMembers(params int[] ids)
Parameters
Type Name Description
System.Int32[] ids

Optional list of Member Ids
Returns
Type Description
IEnumerable<IMember>
Remarks

If no Ids are specified all Members will be retrieved

View Source

GetById(Int32)

Gets a Member by its integer id

Declaration
IMember GetById(int id)
Parameters
Type Name Description
System.Int32 id

System.Int32 Id
Returns
Type Description
IMember IMember
View Source

GetByKey(Guid)

Gets a Member by the unique key

Declaration
IMember GetByKey(Guid id)
Parameters
Type Name Description
Guid id

Id
Returns
Type Description
IMember IMember
Remarks

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

View Source

GetMembersByEmail(String)

Declaration
virtual IEnumerable<IMember> GetMembersByEmail(string email)
Parameters
Type Name Description
System.String email
Returns
Type Description
IEnumerable<IMember>
View Source

GetMembersByGroup(String)

Gets all Members within the specified MemberGroup name

Declaration
IEnumerable<IMember> GetMembersByGroup(string memberGroupName)
Parameters
Type Name Description
System.String memberGroupName

Name of the MemberGroup
Returns
Type Description
IEnumerable<IMember>
View Source

GetMembersByMemberType(Int32)

Gets all Members for the MemberType id

Declaration
IEnumerable<IMember> GetMembersByMemberType(int memberTypeId)
Parameters
Type Name Description
System.Int32 memberTypeId

Id of the MemberType
Returns
Type Description
IEnumerable<IMember>
View Source

GetMembersByMemberType(String)

Gets all Members for the specified MemberType alias

Declaration
IEnumerable<IMember> GetMembersByMemberType(string memberTypeAlias)
Parameters
Type Name Description
System.String memberTypeAlias

Alias of the MemberType
Returns
Type Description
IEnumerable<IMember>
View Source

GetMembersByPropertyValue(String, DateTime, ValuePropertyMatchType)

Gets a list of Members based on a property search

Declaration
IEnumerable<IMember>? GetMembersByPropertyValue(string propertyTypeAlias, DateTime value, ValuePropertyMatchType matchType = ValuePropertyMatchType.Exact)
Parameters
Type Name Description
System.String propertyTypeAlias

Alias of the PropertyType to search for
DateTime value

System.DateTime Value to match
ValuePropertyMatchType matchType

The type of match to make as StringPropertyMatchType. Default is Exact
Returns
Type Description
System.Nullable<IEnumerable<IMember>>
View Source

GetMembersByPropertyValue(String, Boolean)

Gets a list of Members based on a property search

Declaration
IEnumerable<IMember>? GetMembersByPropertyValue(string propertyTypeAlias, bool value)
Parameters
Type Name Description
System.String propertyTypeAlias

Alias of the PropertyType to search for
System.Boolean value

System.Boolean Value to match
Returns
Type Description
System.Nullable<IEnumerable<IMember>>
View Source

GetMembersByPropertyValue(String, Int32, ValuePropertyMatchType)

Gets a list of Members based on a property search

Declaration
IEnumerable<IMember>? GetMembersByPropertyValue(string propertyTypeAlias, int value, ValuePropertyMatchType matchType = ValuePropertyMatchType.Exact)
Parameters
Type Name Description
System.String propertyTypeAlias

Alias of the PropertyType to search for
System.Int32 value

System.Int32 Value to match
ValuePropertyMatchType matchType

The type of match to make as StringPropertyMatchType. Default is Exact
Returns
Type Description
System.Nullable<IEnumerable<IMember>>
View Source

GetMembersByPropertyValue(String, String, StringPropertyMatchType)

Gets a list of Members based on a property search

Declaration
IEnumerable<IMember>? GetMembersByPropertyValue(string propertyTypeAlias, string value, StringPropertyMatchType matchType = StringPropertyMatchType.Exact)
Parameters
Type Name Description
System.String propertyTypeAlias

Alias of the PropertyType to search for
System.String value

System.String Value to match
StringPropertyMatchType matchType

The type of match to make as StringPropertyMatchType. Default is Exact
Returns
Type Description
System.Nullable<IEnumerable<IMember>>
View Source

UpdateLoginPropertiesAsync(IMember)

Saves only the properties related to login for the member, using an optimized, non-locking update.

Declaration
virtual Task UpdateLoginPropertiesAsync(IMember member)
Parameters
Type Name Description
IMember member

The member to update.
Returns
Type Description
Task

Used to avoid the full save of the member object after a login operation.