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>, IMembershipRoleService<IMember>, IContentServiceBase<IMember>, IContentServiceBase, IService

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

Delete(IMember, Int32)

Permanently deletes an IMember object

Declaration
Attempt<OperationResult> Delete(IMember member, int userId = -1)
Parameters
Type Name Description
IMember member

The IMember to delete
System.Int32 userId

Id of the User deleting the Member
Returns
Type Description
Attempt<OperationResult>
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

FilterAsync(MemberFilter, String, Direction, Int32, Int32)

Declaration
Task<PagedModel<IMember>> FilterAsync(MemberFilter memberFilter, string orderBy = "username", Direction orderDirection = Direction.Ascending, int skip = 0, int take = 100)
Parameters
Type Name Description
MemberFilter memberFilter
System.String orderBy
Direction orderDirection
System.Int32 skip
System.Int32 take
Returns
Type Description
Task<PagedModel<IMember>>
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(Int32, Int32, out Int64, String, Direction, String, String)

Gets a list of paged IMember objects

Declaration
virtual IEnumerable<IMember> GetAll(int skip, int take, out long totalRecords, string orderBy, Direction orderDirection, string memberTypeAlias = null, string filter = "")
Parameters
Type Name Description
System.Int32 skip

Amount to skip.
System.Int32 take

Amount to take.
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

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

GetByKeysAsync(Guid[])

Gets IMember objects by Ids

Declaration
Task<IEnumerable<IMember>> GetByKeysAsync(params Guid[] ids)
Parameters
Type Name Description
Guid[] ids

Ids of the Member to retrieve
Returns
Type Description
Task<IEnumerable<IMember>> 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

Save(IEnumerable<IMember>, Int32)

Saves a list of IMember objects

Declaration
Attempt<OperationResult> Save(IEnumerable<IMember> members, int userId = -1)
Parameters
Type Name Description
IEnumerable<IMember> members

Collection of IMember to save
System.Int32 userId

Id of the User saving the Members
Returns
Type Description
Attempt<OperationResult>
View Source

Save(IMember, Int32)

Saves a single IMember object

Declaration
Attempt<OperationResult> Save(IMember media, int userId = -1)
Parameters
Type Name Description
IMember media

The IMember to save
System.Int32 userId

Id of the User saving the Member
Returns
Type Description
Attempt<OperationResult>