Share via


TermStore.CreateGroup method

Creates a new Group object in a TermStore.

Namespace:  Microsoft.SharePoint.Client.Taxonomy
Assembly:  Microsoft.SharePoint.Client.Taxonomy (in Microsoft.SharePoint.Client.Taxonomy.dll)

Syntax

'Declaration
Public Function CreateGroup ( _
    name As String, _
    groupId As Guid _
) As TermGroup
'Usage
Dim instance As TermStore
Dim name As String
Dim groupId As Guid
Dim returnValue As TermGroup

returnValue = instance.CreateGroup(name, _
    groupId)
public TermGroup CreateGroup(
    string name,
    Guid groupId
)

Parameters

  • name
    Type: System.String

    The name of the new Group being created.

  • groupId
    Type: System.Guid

    The ID of the new Group being created.

Return value

Type: Microsoft.SharePoint.Client.Taxonomy.TermGroup

Exceptions

Exception Condition
UnauthorizedAccessException

The current user has insufficient permissions to perform this operation.

ArgumentException

The name parameter is invalid. It either contains invalid characters or is too long.

ArgumentException

Group names must be unique.

ArgumentNullException

The name cannot be a null reference (Nothing in Visual Basic) or empty.

Remarks

The name cannot exceed 255 characters, and it cannot contain any of the following illegal characters: ; " < > | & tab.

In addition, the name must be a unique group name within the current TermStore.

The current user must have ManageTermStore() permission in order to use this method.

CommitAll() must be called in order to save this change to the database.

See also

Reference

TermStore class

TermStore members

Microsoft.SharePoint.Client.Taxonomy namespace