Philiprehberger.EmailValidator
0.2.0
dotnet add package Philiprehberger.EmailValidator --version 0.2.0
NuGet\Install-Package Philiprehberger.EmailValidator -Version 0.2.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Philiprehberger.EmailValidator" Version="0.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Philiprehberger.EmailValidator" Version="0.2.0" />
<PackageReference Include="Philiprehberger.EmailValidator" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Philiprehberger.EmailValidator --version 0.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Philiprehberger.EmailValidator, 0.2.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Philiprehberger.EmailValidator@0.2.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Philiprehberger.EmailValidator&version=0.2.0
#tool nuget:?package=Philiprehberger.EmailValidator&version=0.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Philiprehberger.EmailValidator
RFC 5321/5322 compliant email validation with typo suggestions, disposable email detection, and bulk validation.
Installation
dotnet add package Philiprehberger.EmailValidator
Usage
Quick Check
using Philiprehberger.EmailValidator;
bool valid = EmailValidator.IsValid("user@example.com");
// true
bool invalid = EmailValidator.IsValid("not-an-email");
// false
Detailed Validation
using Philiprehberger.EmailValidator;
var result = EmailValidator.Validate("user@example.com");
// result.IsValid → true
// result.Error → null
// result.NormalizedAddress → "user@example.com"
var failed = EmailValidator.Validate("user@.com");
// failed.IsValid → false
// failed.Error → "Domain must not contain empty labels."
Internationalized Domains
using Philiprehberger.EmailValidator;
var result = EmailValidator.Validate("user@münchen.de");
// result.IsValid → true
// result.NormalizedAddress → "user@xn--mnchen-3ya.de"
Typo Suggestions
using Philiprehberger.EmailValidator;
var result = EmailValidator.ValidateWithSuggestion("user@gmial.com");
// result.IsValid → true
// result.Suggestion → "user@gmail.com"
Disposable Email Detection
using Philiprehberger.EmailValidator;
bool disposable = EmailValidator.IsDisposable("user@mailinator.com");
// true
bool legit = EmailValidator.IsDisposable("user@gmail.com");
// false
Bulk Validation
using Philiprehberger.EmailValidator;
var results = EmailValidator.ValidateMany(new[] { "a@b.com", "invalid", "c@d.org" });
// results[0].IsValid → true
// results[1].IsValid → false
// results[2].IsValid → true
API
| Member | Returns | Description |
|---|---|---|
EmailValidator.IsValid(string email) |
bool |
Returns whether the email address is valid. |
EmailValidator.Validate(string email) |
ValidationResult |
Returns a detailed validation result with error and normalized address. |
ValidationResult.IsValid |
bool |
Whether the email address is valid. |
ValidationResult.Error |
string? |
Error message if invalid, null if valid. |
ValidationResult.NormalizedAddress |
string? |
Lowercased, trimmed email if valid, null if invalid. |
ValidationResult.Suggestion |
string? |
Suggested corrected email if a domain typo was detected, null otherwise. |
ValidationResult.IsDisposable |
bool |
Whether the email domain belongs to a known disposable email provider. |
EmailValidator.ValidateWithSuggestion(string email) |
ValidationResult |
Validates and suggests a correction if the domain is a typo of a common provider. |
EmailValidator.ValidateMany(IEnumerable<string> emails) |
IReadOnlyList<ValidationResult> |
Validates multiple email addresses and returns results in order. |
EmailValidator.IsDisposable(string email) |
bool |
Checks whether the email domain is a known disposable provider. |
Development
dotnet build src/Philiprehberger.EmailValidator.csproj --configuration Release
Support
If you find this project useful:
License
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.