Releases: arichika/RotativaCore
Releases · arichika/RotativaCore
4.1.0
features
- Property
SaveOnServerPath
is discontinued. - Support new delegate.
OnNoContentAsync()
- Specifies an alternative process in the case of an empty content response
from the conversion source or an error response (error response to standard output)
by wkhtmltopdf in converting an empty content. - Within this delegate, direct operations (e.g., redirection instructions) must be performed on the ActionContext.
- When this process is called,
TryCustomizeAsync
andOnBuildFileSuccess
are not executed. - To use this feature effectively, it is essential to return
wkhtmltoX
with NoContent, i.e., an empty rendering element (empty Body response). This is becausewkhtmltoX
will respond with an error condition on its standard output and exit. - To take advantage of this, I modified the internal processing so that
wkhtnmltoX
returnsWkhtmlDriverStandardErrorException
ifwkhtnmltoX
terminates abnormally and the return data is empty. IfOnNoContentAsync()
is defined in this case, this process is called because the converted data is always empty when this error is detected. - If
OnNoContentAsync()
is not defined, there is no difference in behavior except that the thrown Exception is more detailed.
- Specifies an alternative process in the case of an empty content response
public async Task<IActionResult> TestEmptyContentActionAsPdfInline()
{
return new ActionAsPdf("EmptyContent")
{
ContentDisposition = ContentDisposition.Inline,
OnNoContentAsync = async (ex, context) =>
{
// e.g.
context.HttpContext.Response.Redirect("https://example.com/");
}
};
}
4.0.0
features
- Property
SaveOnServerPath
is discontinued. - Support new delegate.
TryCustomizeAsync()
- If you want to customize the generated binary file before
OnBuildFileSuccess()
, use this. - Please return true to continue processing, false to drop with error.
- If you want to customize the generated binary file before
public ActionResult TestInlie()
{
return new ActionAsPdf("Index")
{
ContentDisposition = ContentDisposition.Inline,
TryCustomizeAsync = async (stream, context, fineName) =>
{
// some code done.
return true;
// e.g.
var customizeStream = new MemoryStream();
await stream.CopyToAsync(customizeStream);
// ...
stream.SetLength(0);
await customizeStream.CopyToAsync(stream);
return true;
},
};
}
2.2.0-updateSamples
Update "Sample Web Application" only.
There is no change in the RotativaCore library.