Class CreateFileExtensions
Extension methods for creating network files.
Inherited Members
Namespace: Hiero
Assembly: Hiero.dll
Syntax
public static class CreateFileExtensions
Methods
| Edit this page View SourceCreateFileAsync(ConsensusClient, CreateFileParams, Action<IConsensusContext>?)
Creates a new file with the given content.
Declaration
public static Task<FileReceipt> CreateFileAsync(this ConsensusClient client, CreateFileParams createParameters, Action<IConsensusContext>? configure = null)
Parameters
| Type | Name | Description |
|---|---|---|
| ConsensusClient | client | The Consensus Node Client executing the file create. |
| CreateFileParams | createParameters | File creation parameters specifying contents and ownership of the file. |
| 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<FileReceipt> | A transaction receipt with a description of the newly created file. |
Examples
var createReceipt = await client.CreateFileAsync(new CreateFileParams
{
Contents = Encoding.UTF8.GetBytes("Hello from Hiero SDK!"),
Endorsements = new[] { payerEndorsement },
Memo = "Sample file"
});
Console.WriteLine($"File created: {createReceipt.File}");
Exceptions
| Type | Condition |
|---|---|
| ArgumentOutOfRangeException | If required arguments are missing. |
| InvalidOperationException | If required context configuration is missing. |
| PrecheckException | If the gateway node rejected the request upon submission. |
| ConsensusException | If the network was unable to come to consensus before the duration of the transaction expired. |
| TransactionException | If the network rejected the create request as invalid or had missing data. |