This documentation is archived and is not being maintained.

Principal.Save Method (PrincipalContext)

Saves the changes that were made on the principal object to the store. If this is a new principal object, this method inserts it into the specified context. If the principal has already been persisted, it is moved from the original context to the specified context.

Namespace:  System.DirectoryServices.AccountManagement
Assembly:  System.DirectoryServices.AccountManagement (in System.DirectoryServices.AccountManagement.dll)

public void Save(
	PrincipalContext context
)

Parameters

context
Type: System.DirectoryServices.AccountManagement.PrincipalContext
The PrincipalContext that specifies the server or domain against which operations are performed.

ExceptionCondition
InvalidOperationException

The principal has not yet been associated with a PrincipalContext object.

This type of principal cannot be inserted in the store.

PrincipalOperationException

An exception occurred when saving changes to the store, or updating the group membership in the store.

[T:System>DirectoryServices.AccountManagement.PrincipalExistsException]

The principal already occurs in the store.

PasswordException

The password does not meet complexity requirements.

If the specified principal context differs from the existing context, the principal is moved to the specified context, and the principal object no longer is located in the old location. If the specified context is identical to the existing context, this method saves the updates that were made on the principal object to the store. The context type of the specified context must be the same type as the current context type. This method may not be called by using the computer context type.

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: