Magicodes.IE在.NET Core中通過請求頭匯出多種格式檔案
阿新 • • 發佈：2020-06-22
# 前言
在2.2里程碑中我們增加了一些新的功能,正如標題所寫通過請求頭進行匯出我們不同格式的檔案.下面我們來看一下如何使用.通過這種方式無論是對我們的資料多用途，還是說對我們的資料校驗都做到了輕鬆易配。
同時我們也將在本週釋出2.3版本，另外3.0版本我們將進行一次大的效能提升。3.0版本我們將對Razor引擎以及匯出引擎進行更換，包括對所有程式碼的重構，這是值得期待的。
上週我們釋出了2.2.5版本更新如下：
- **【Nuget】版本更新到2.2.5**
- **【Excel匯出】增加分欄、分sheet、追加rows匯出 [#74](https://github.com/dotnetcore/Magicodes.IE/issues/74)**
- exporter.Append(list1).SeparateByColumn().Append(list2).ExportAppendData(filePath);
- exporter.Append(list1).SeparateBySheet().Append(list2).ExportAppendData(filePath);
- exporter.Append(list1).SeparateByRow().AppendHeaders().Append(list2).ExportAppendData(filePath);
- **[Excel匯出】修復‘IsAllowRepeat＝true’ [#107](https://github.com/dotnetcore/Magicodes.IE/issues/107)**
- **[Pdf匯出】增加PDF擴充套件方法，支援通過以引數形式傳遞特性引數 [#104](https://github.com/dotnetcore/Magicodes.IE/issues/104)**
- Task ExportListBytesByTemplate(ICollection＜T＞ data, PdfExporterAttribute pdfExporterAttribute,string temple);
- Task ExportBytesByTemplate＜T＞(T data, PdfExporterAttribute pdfExporterAttribute,string template);
# 主要步驟
### 1.安裝包
```powershell
Install-Package Magicodes.IE.AspNetCore
```
### 2.開始配置
在`Startup.cs`的Configure()方法中,在UseRouting()中介軟體之後,註冊如下中介軟體
```csharp
public void Configure(IApplicationBuilder app)
{
app.UseRouting();
app.UseMagiCodesIE();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
}
```
上面這種以中介軟體形式可以為我們提供匯出服務，那麼我們再看一下另一種方式如下所示：
```csharp
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers(options=>options.Filters.Add(typeof(MagicodesFilter)));
}
```
上面兩種方式都可以為我們提供匯出服務，我們只需要對我們的控制器進行配置我們的特性，在這邊呢 特性主要做的是一個標識作用，標識他的一些相關的內容資料，同時標識他可以當成檔案匯出。
```
[HttpGet("excel")]
[Magicodes(Type = typeof(ExportTestDataWithAttrs))]
public List Excel()
{
return GenFu.GenFu.ListOf(100);
}
```
上面程式碼片段中我們標識這個類允許被匯出。同時我們需要通過Type指定我們被匯出類的型別。
這樣填寫完後我們可以通過對該地址的呼叫，但是注意我們必須要新增請求頭以標識被匯出的檔案型別。如果不新增請求頭，那麼此處將返回的還是json格式的資料。請求頭名稱為`Magicodes-Type`
```
///
/// XLSX
///
/// PDF
///
internal const string PDFHttpContentMediaType = "application/pdf";
///
/// DOCX
///
internal const string DOCXHttpContentMediaType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
///
/// HTML
/// ()
};
for (var i = 0; i < 500; i++)
input.ReceiptInfoInputs.Add(new BatchPortraitReceiptInfoDto
{
Amount = 22939.43M,
Grade = "2019秋",
IdNo = "43062619890622xxxx",
Name = "張三",
PaymentMethod = "微信支付",
Profession = "運動訓練",
Remark = "學費",
TradeStatus = "已完成",
TradeTime = DateTime.Now,
UppercaseAmount = "貳萬貳仟玖佰叄拾玖圓肆角叄分",
Code = "1907180000" + i
});
return input;
}
[HttpGet("Html")]
[Magicodes(Type = typeof(ReceiptInfo), TemplatePath = ".//ExportTemplates//receipt.cshtml")]
public ReceiptInfo Html()
{
return new ReceiptInfo
{
Amount = 22939.43M,
Grade = "2019秋",
IdNo = "43062619890622xxxx",
Name = "張三",
Payee = "湖南心萊資訊科技有限公司",
PaymentMethod = "微信支付",
Profession = "運動訓練",
Remark = "學費",
TradeStatus = "已完成",
TradeTime = DateTime.Now,
UppercaseAmount = "貳萬貳仟玖佰叄拾玖圓肆角叄分",
Code = "19071800001"
};
}
```
## Reference
https://github.com/dotnetcore/Magic