Class EnterTheDateBuilder

Namespace

CSF.Screenplay.Selenium.Builders

Assembly

CSF.Screenplay.Selenium.dll

A builder type which creates an instance of EnterTheDate.

public class EnterTheDateBuilder : IGetsPerformable

Inheritance

object

EnterTheDateBuilder

Implements

IGetsPerformable

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Constructors

EnterTheDateBuilder(DateTime?)

Initializes a new instance of the EnterTheDateBuilder class with the specified date.

public EnterTheDateBuilder(DateTime? date)

Parameters

date DateTime?

The date to enter, or null

Methods

ForTheCultureNamed(string)

Specifies the culture for which to enter the date. This must be the culture in which the web browser is operating.

public EnterTheDateBuilder ForTheCultureNamed(string cultureIdentifier)

Parameters

cultureIdentifier string

A culture identifier string

Returns

EnterTheDateBuilder

This same builder, so calls may be chained

Examples

For example, a British English browser en-GB expects dates to be entered in the format ddMMyyyy. However, a US English browser en-US expects dates to be entered in the format MMddyyyy.

The cultureIdentifier parameter of this method must be the culture identifier of the culture which the browser is operating under, such as en-GB.

Remarks

Web browser are culture-aware applications and they will render the input/display value of a date field using the culture in which their operating system is configured. This impacts the manner in which users input dates. If this method is not used, the task returned by this builder will use the culture of the operating system/environment that is executing the Screenplay Performance. This is usually OK when running the web browser locally, but it might not match the browser's culture when using remote web browsers.

Exceptions

ArgumentNullException

If cultureIdentifier is null

CultureNotFoundException

If cultureIdentifier indicates a culture which is not found

GetPerformable()

Gets the performable object from the current instance.

public IPerformable GetPerformable()

Returns

IPerformable

A performable object

Into(ITarget)

Specifies the target element into which to enter the date. This must be an <input type="date"> element.

public EnterTheDateBuilder Into(ITarget target)

Parameters

target ITarget

The target element

Returns

EnterTheDateBuilder

This same builder, so calls may be chained

Exceptions

ArgumentNullException

If target is null

InvalidOperationException

If this method is used more than once