Principal.Save Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 store.
Overloads
| Save() |
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 store. |
| Save(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. |
Save()
- Source:
- Principal.cs
- Source:
- Principal.cs
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 store.
public:
void Save();public void Save ();[System.Security.SecurityCritical]
public void Save ();member this.Save : unit -> unit[<System.Security.SecurityCritical>]
member this.Save : unit -> unitPublic Sub Save ()- Attributes
Exceptions
The principal has not yet been associated with a PrincipalContext object.
This type of principal cannot be inserted in the store.
An exception occurred when saving changes to the store, or updating the group membership in the store.
The principal already occurs in the store.
The password does not meet complexity requirements.
Applies to
Save(PrincipalContext)
- Source:
- Principal.cs
- Source:
- Principal.cs
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.
public:
void Save(System::DirectoryServices::AccountManagement::PrincipalContext ^ context);public void Save (System.DirectoryServices.AccountManagement.PrincipalContext context);[System.Security.SecurityCritical]
public void Save (System.DirectoryServices.AccountManagement.PrincipalContext context);member this.Save : System.DirectoryServices.AccountManagement.PrincipalContext -> unit[<System.Security.SecurityCritical>]
member this.Save : System.DirectoryServices.AccountManagement.PrincipalContext -> unitPublic Sub Save (context As PrincipalContext)Parameters
- context
- PrincipalContext
The PrincipalContext that specifies the server or domain against which operations are performed.
- Attributes
Exceptions
The principal has not yet been associated with a PrincipalContext object.
This type of principal cannot be inserted in the store.
An exception occurred when saving changes to the store, or updating the group membership in the store.
The principal already occurs in the store.
The password does not meet complexity requirements.
Remarks
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.
