Sections.CreateAsync(SectionBreakType, CancellationToken) Method
Inserts a section break at the current position and creates a new section.
Namespace: DevExpress.Blazor.RichEdit
Assembly: DevExpress.Blazor.RichEdit.v24.2.dll
NuGet Package: DevExpress.Blazor.RichEdit
Declaration
public ValueTask<Section> CreateAsync(
SectionBreakType type = SectionBreakType.NextPage,
CancellationToken cancellationToken = default(CancellationToken)
)
Optional Parameters
Name | Type | Default | Description |
---|---|---|---|
type | SectionBreakType | NextPage | The type of a break. |
cancellationToken | CancellationToken | null | An object that propagates a cancellation notification. |
Returns
Type | Description |
---|---|
ValueTask<Section> | A structure that stores an awaitable result of an asynchronous operation. The awaitable result is a section object. |
Remarks
<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 canceled. */
try {
documentAPI = richEdit.DocumentAPI;
@* ... *@
for (int i = 0; i < 5; i++) {
await documentAPI.AddTextAsync("New Section");
await documentAPI.Sections.CreateAsync();
}
@* ... *@
}
catch (OperationCanceledException e) {
Console.WriteLine($"{nameof(OperationCanceledException)} thrown with message: {e.Message}");
}
}
See Also