FormsAuthenticationUserCollection.Add(FormsAuthenticationUser) Method

Definition

Adds a FormsAuthenticationUser object to the collection.

public:
 void Add(System::Web::Configuration::FormsAuthenticationUser ^ user);
public void Add (System.Web.Configuration.FormsAuthenticationUser user);
member this.Add : System.Web.Configuration.FormsAuthenticationUser -> unit
Public Sub Add (user As FormsAuthenticationUser)

Parameters

user
FormsAuthenticationUser

The FormsAuthenticationUser object to add to the collection.

Exceptions

The FormsAuthenticationUser object already exists in the collection, or the collection is read-only.

Examples

The following code example shows how to use the Add method.

// Using method Add.

// Define the SHA1 encrypted password.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
string password = 
    "5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8";
// Define the user name.
string userName = "newUser";

// Create the new user.
FormsAuthenticationUser currentUser = 
    new FormsAuthenticationUser(userName, password);

// Execute the Add method.
formsAuthenticationCredentials.Users.Add(currentUser);

// Update if not locked
if (!authenticationSection.SectionInformation.IsLocked)
{
    configuration.Save();
}
' Using method Add.
' Define the SHA1 encrypted password.
' This example uses the SHA1 algorithm.
' Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
  Dim password As String = _
  "5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"
' Define the user name.
Dim userName As String = "newUser"

' Create the new user.
  Dim currentUser _
  As New FormsAuthenticationUser(userName, password)

' Execute the Add method.
formsAuthenticationCredentials.Users.Add(currentUser)

' Update if not locked
If Not authenticationSection.SectionInformation.IsLocked Then
   configuration.Save()
End If

Remarks

The collection must not contain a FormsAuthenticationUser object with the same name.

Applies to