Method SendKeys

dotnet/src/webdriver/WebElement.cs:571–601

Simulates typing text into the element. The text to type into the element. The text to be typed may include special characters like arrow keys, backspaces, function keys, and so on. Valid special keys are defined in . Thrown when the target elem

(string text)

    /// <exception cref="InvalidElementStateException">Thrown when the target element is not enabled.</exception>
    /// <exception cref="StaleElementReferenceException">Thrown when the target element is no longer valid in the document DOM.</exception>
    public virtual void SendKeys(string text)
    {
        if (text == null)
        {
            throw new ArgumentNullException(nameof(text), "text cannot be null");
        }

        var fileNames = text.Split('\n');
        if (fileNames.All(this.driver.FileDetector.IsFile))
        {
            var uploadResults = new List<string>();
            foreach (var fileName in fileNames)
            {
                uploadResults.Add(this.UploadFile(fileName));
            }
            text = string.Join("\n", uploadResults);
        }

        // N.B. The Java remote server expects a CharSequence as the value input to
        // SendKeys. In JSON, these are serialized as an array of strings, with a
        // single character to each element of the array. Thus, we must use ToCharArray()
        // to get the same effect.
        // TODO: Remove either "keysToSend" or "value" property, whichever is not the
        // appropriate one for spec compliance.
        Dictionary<string, object> parameters = new Dictionary<string, object>();
        parameters.Add("id", this.Id);
        parameters.Add("text", text);
        parameters.Add("value", text.ToCharArray());

        this.Execute(DriverCommand.SendKeysToElement, parameters);
    }

    /// <summary>
    /// Submits this element to the web server.