Class AppendFileExtensions
Extension methods for appending content to network files.
Inherited Members
Namespace: Hiero
Assembly: Hiero.dll
Syntax
public static class AppendFileExtensions
Methods
| Edit this page View SourceAppendFileAsync(ConsensusClient, AppendFileParams, Action<IConsensusContext>?)
Appends content to an existing file.
Declaration
public static Task<TransactionReceipt> AppendFileAsync(this ConsensusClient client, AppendFileParams appendParameters, Action<IConsensusContext>? configure = null)
Parameters
| Type | Name | Description |
|---|---|---|
| ConsensusClient | client | The Consensus Node Client executing the file append. |
| AppendFileParams | appendParameters | Configuration object identifying the file and contents to append. |
| Action<IConsensusContext> | configure | Optional callback method providing an opportunity to modify the execution configuration for just this method call. It is executed prior to submitting the request to the network. |
Returns
| Type | Description |
|---|---|
| Task<TransactionReceipt> | A transaction receipt indicating the success of the operation. |
Examples
await client.AppendFileAsync(new AppendFileParams
{
File = createReceipt.File,
Contents = Encoding.UTF8.GetBytes(" More content appended.")
});
Exceptions
| Type | Condition |
|---|---|
| ArgumentException | If required arguments are missing or invalid. |
| InvalidOperationException | If required context configuration is missing. |
| PrecheckException | If the gateway node refused the transaction. Only a code about the transaction itself proves it did not execute; any other code leaves the outcome unknown, so settle it by its transaction id on a mirror node rather than resubmitting it (see PrecheckException). |
| ConsensusException | If the outcome could not be confirmed: the transaction may have executed, so settle it by its transaction id on a mirror node rather than resubmitting it. |
| TransactionException | If the network rejected the append request as invalid or had missing data. |