Table of Contents

Class TlumachPhoneAttribute

Namespace
Tlumach.DataAnnotations
Assembly
Tlumach.DataAnnotations.dll

A telephone number validation attribute that takes its error message from a class created by Tlumach Generator.

The message template receives the display name of the member as {0}.

[AttributeUsage(AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Parameter, AllowMultiple = false)]
public sealed class TlumachPhoneAttribute : DataTypeAttribute, ITlumachLocalizedErrorMessage
Inheritance
TlumachPhoneAttribute
Implements
Inherited Members

Remarks

PhoneAttribute is sealed, so this attribute derives from DataTypeAttribute the way the sealed one does and delegates the check itself to an instance of it. The rule is therefore identical to the one of the framework and follows any future correction of it, and no expression from the framework is copied into Tlumach.

Constructors

TlumachPhoneAttribute()

Initializes a new instance of the TlumachPhoneAttribute class. Set TranslationClass and TranslationKey in the annotation, or leave both unset to behave exactly like PhoneAttribute.

public TlumachPhoneAttribute()

TlumachPhoneAttribute(Type, string)

Initializes a new instance of the TlumachPhoneAttribute class that takes its message from the given translation.

public TlumachPhoneAttribute(Type translationClass, string translationKey)

Parameters

translationClass Type

The class created by Tlumach Generator, or a nested group class inside one, that provides the message.

translationKey string

The name of the translation unit member in translationClass, or the key of a translation entry.

Properties

CultureSource

Gets the culture, for which the message is read.

public TranslationCultureSource CultureSource { get; set; }

Property Value

TranslationCultureSource

TranslationClass

Gets the class created by Tlumach Generator, or a nested group class inside one, that provides the message.

public Type? TranslationClass { get; set; }

Property Value

Type

TranslationKey

Gets the name of the translation unit member in TranslationClass, or the key of a translation entry.

public string? TranslationKey { get; set; }

Property Value

string

Methods

FormatErrorMessage(string)

Formats the error message, taking it from the configured translation when there is one.

public override string FormatErrorMessage(string name)

Parameters

name string

The display name of the member being validated. It becomes the {0} argument of the template.

Returns

string

The formatted message.

Exceptions

InvalidOperationException

Thrown when the Tlumach configuration of the attribute is invalid or the message cannot be resolved.

IsValid(object?)

Tells whether the value is a valid telephone number, using the rule of PhoneAttribute.

public override bool IsValid(object? value)

Parameters

value object

The value to check.

Returns

bool

true when the value is null or a valid telephone number.