This project uses SponsorLink to attribute sponsor status (direct, indirect or implicit). For IDE usage (without warnings), sponsor status is required. IDE-only warnings will be issued after a grace period otherwise.

This package generates a static ThisAssembly.Resources class with public properties exposing typed APIs to retrieve the contents of embedded resources.

  <ItemGroup>
    <EmbeddedResource Include="Content/Docs/License.md" />
  </ItemGroup>

Since markdown files are text files, the API will expose a Text property property for it that will read its content once and cache it:

The $(EmbeddedResourceStringExtensions) MSBuild property allows customizing which file extensions get treated as text files. By default, it's defined as:

  <PropertyGroup>
    <EmbeddedResourceStringExtensions>.txt|.cs|.sql|.json|.md</EmbeddedResourceStringExtensions>
  </PropertyGroup>

You can append additional file extensions to this list, or override it completely. The list must be pipe-separated.

You can always use the provided GetStream and GetBytes for more advanced scenarios (or for non-text resources).

Optionally, you can specify the Kind metadata for a specific EmbeddedResource you want treated as a text file:

<ItemGroup>
    <EmbeddedResource Include="query.kql" Kind="Text" />
</ItemGroup>

You can also add a Comment item metadata attribute, which will be used as the <summary> XML doc for the generated member.

Adding dynamic resources

You can also provide additional embedded resources dynamically, by running a target before PrepareEmbeddedResources:

  <Target Name="AddDynamicResources" BeforeTargets="PrepareEmbeddedResources">
    <ItemGroup>
      <EmbeddedResource Include="Content/Docs/$(Configuration).md" />
    </ItemGroup>
  </Target>

Customizing the generated code

The following MSBuild properties can be used to customize the generated code:

Sponsors

Learn more about GitHub Sponsors