## WebSecurity.IsConfirmed() Method
The `WebSecurity.IsConfirmed()` method is a built-in helper in ASP.NET Web Pages (specifically within the SimpleMembership provider) that checks whether a specified user account has been confirmed.
This method is commonly used in registration workflows where users must verify their email addresses (e.g., by clicking a link sent via email) before they are allowed to log in.
---
## Definition
Returns a boolean value indicating whether the specified user account has been confirmed.
---
## Syntax
### C# Syntax
```csharp
bool isConfirmed = WebSecurity.IsConfirmed(userName);
```
### VB.NET Syntax
```vb
Dim isConfirmed As Boolean = WebSecurity.IsConfirmed(userName)
```
---
## Parameters
| Parameter | Type | Description |
| :--- | :--- | :--- |
| `userName` | `String` | The unique username of the account to check. |
---
## Return Value
| Return Type | Description |
| :--- | :--- |
| `Boolean` | Returns `true` if the user account has been confirmed; otherwise, `false`. |
---
## Exceptions and Errors
An `InvalidOperationException` will be thrown when calling this method if:
* The `WebSecurity.InitializeDatabaseConnection()` method has not been called first to initialize the membership database.
* **SimpleMembership** is not initialized or has been explicitly disabled in the website configuration.
---
## Remarks
* The `IsConfirmed()` method checks the status of the user account identified by the `userName` parameter.
* If a user has successfully completed the confirmation process (such as clicking a confirmation link sent to their registered email address), this method returns `true`.
* If a user account is registered but not yet confirmed, they will be blocked from logging in using the standard `WebSecurity.Login()` method.
---
## Code Example
The following example demonstrates how to use `WebSecurity.IsConfirmed()` to check a user's status before attempting a login or when managing user accounts.
```cshtml
@{
Layout = "~/_SiteLayout.cshtml";
Page.Title = "Account Status Check";
string message = "";
if (IsPost) {
string email = Request;
// Ensure the membership database is initialized
// WebSecurity.InitializeDatabaseConnection("UsersDb", "UserProfile", "UserId", "Email", autoCreateTables: true);
if (WebSecurity.UserExists(email)) {
if (WebSecurity.IsConfirmed(email)) {
message = "Your account is active and confirmed. You can log in.";
} else {
message = "Your account is pending confirmation. Please check your email inbox.";
}
} else {
message = "No account found with that email address.";
}
}
}
Check Account Status
Check Your Account Status
@if (!message.IsEmpty()) {
Status: @message
}
```
---
## Technical Reference
| Attribute | Value |
| :--- | :--- |
| **Namespace** | `WebMatrix.WebData` |
| **Assembly** | `WebMatrix.WebData.dll` |