Table of Contents

Struct PhoneNumber

Namespace
Signal.Domain.ValueObjects
Assembly
Signal.Domain.dll

A phone number in E.164 format (+ followed by 7–15 digits, e.g. +4915112345678).

public readonly record struct PhoneNumber : IParsable<PhoneNumber>, IEquatable<PhoneNumber>
Implements
Inherited Members

Remarks

Instances are always valid: they can only be created through Parse(string) or TryParse(string?, out PhoneNumber), which normalise common formatting (spaces, dashes, dots, parentheses and a leading 00). Implements IParsable<TSelf>, so command parameters of this type are bound automatically.

Properties

Value

The normalised E.164 representation, e.g. +4915112345678.

public string Value { get; }

Property Value

string

Methods

Parse(string)

Parses and normalises a phone number.

public static PhoneNumber Parse(string value)

Parameters

value string

Input such as +49 151 1234-5678 or 004915112345678.

Returns

PhoneNumber

The normalised phone number.

Exceptions

InvalidPhoneNumberException

value is not a valid phone number.

ToString()

Returns Value.

public override string ToString()

Returns

string

The E.164 representation, or an empty string for default.

TryParse(string?, out PhoneNumber)

Tries to parse and normalise a phone number.

public static bool TryParse(string? value, out PhoneNumber number)

Parameters

value string

Input such as +49 151 1234-5678 or 004915112345678.

number PhoneNumber

The normalised phone number when the method returns true.

Returns

bool

true if value is a valid phone number.