SubDocument.AddTextAsync(String) Method
Appends the specified text to the sub-document.
Namespace: DevExpress.Blazor.RichEdit
Assembly: DevExpress.Blazor.RichEdit.v21.2.dll
NuGet Package: DevExpress.Blazor.RichEdit
Declaration
public ValueTask<TextSpan> AddTextAsync(
string text
)
Parameters
Name | Type | Description |
---|---|---|
text | String | The text to insert. |
Returns
Type | Description |
---|---|
ValueTask<TextSpan> | A structure that stores an awaitable result of an asynchronous operation. The awaitable result is the inserted text span. |
Remarks
Use the ChangePropertiesAsync(Action<CharacterProperties>) method to specify character properties of the inserted text.
<DxRichEdit @ref="richEdit" />
@code {
DxRichEdit richEdit;
Document documentAPI;
@* ... *@
/* Surround the code that contains an asynchronous operation with a try-catch block to handle
the OperationCanceledException. This exception is thrown when an asynchronous operation is cancelled. */
try {
documentAPI = richEdit.DocumentAPI;
@* ... *@
TextSpan characters = await documentAPI.AddTextAsync("New Text");
await characters.ChangePropertiesAsync(properties => {
if (characters.AllCaps != false)
properties.AllCaps = false;
});
@* ... *@
}
catch (OperationCanceledException e) {
Console.WriteLine($"{nameof(OperationCanceledException)} thrown with message: {e.Message}");
}
}
See Also