When the sheet name is specified as $Property$, it auto splits into multiple sheets if the property is enumerable, Supports template for nested objects

[iyumot]

with template

model

public record struct Identity(int Type, string Id);

private class Fund
{
    public int Id { get; set; }
    public string? Name { get; set; }
    public Identity Identity { get; set; }
    public DateOnly SetupDate { get; set; }

    public List<NetValue> NetValues { get; set; } = [];
}

public record NetValue(DateOnly Date, decimal Value);

data

var value = new
{
    Funds = fundList.Select(x => new
    {
        x.Id,
        x.Name,
        x.Identity,
        x.SetupDate,
        x.NetValues,
        SheetName = x.Name
    })
};

specify sheetname by SheetName property, if not exist set as what in $$ plus 1,2,3

result

Resolves #300

[gemini-code-assist]

Code Review

This pull request introduces multi-sheet expansion capabilities and enhanced object flattening with circular reference protection to the OpenXml template engine. The reviewer identified several critical bugs, including a double increment of the sheet index that breaks file relationships and a loop termination issue that prevents processing multiple template sheets. Additionally, feedback was provided regarding redundant type checks, inefficient regex instantiation, unnecessary decimal parsing, and missing namespace imports required for cross-platform compilation.

[michelebastione]

Thank you for your contribution, I will try to evaluate it as soon as possible. Please change the title and description to include a more detailed description of the intents of the PR.

[michelebastione]

Hello @iyumot, I apologize but I haven't had the time to properly analyse the PR.
I did skim a little bit through it though and noticed all comments were written in Chinese. I kindly request you to translate them to English for facilitating the work of international comtributors and for keeping the codebase consistent.

[michelebastione]

Hello @iyumot could you please address my previous comment concerning the Chinese comments in your code? Thank you.

[michelebastione]

@iyumot @k1k-xxsc Please grant mantainers access to modify the PR.

[iyumot]

This pull request comes from an organization repository, and it seems the maintainer permission setting is unavailable here. I've sent you an invitation, but I'm not sure if there are other ways to get this done.

[iyumot]

or you can use my code whatever you want and close this pr

[michelebastione]

Thanks for the invite, I will accept it for ease of collaboration this time.

[michelebastione]

@iyumot Please add instructions on how to use the feature to the readme

[iyumot]

I have submitted the commit to the extend branch. i wrote in readme-v2.md

…

---- Replied Message ---- | From | Michele ***@***.***> | | Date | 06/07/2026 21:42 | | To | ***@***.***> | | Cc | ***@***.***>***@***.***> | | Subject | Re: [mini-software/MiniExcel] When the sheet name is specified as $Property$, it auto splits into multiple sheets if the property is enumerable, Supports template for nested objects (PR #959) | michelebastione left a comment (mini-software/MiniExcel#959) @iyumot Please add instructions on how to use the feature to the readme — Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today! You are receiving this because you were mentioned.Message ID: ***@***.***>