ASP.NET 開源匯入匯出庫Magicodes.IE 完成Excel圖片匯入匯出
阿新 • • 發佈：2020-03-18
# Magicodes.IE Excel圖片匯入匯出
為了更好的根據實際功能來迭代，從2.2的里程碑規劃開始，我們將結合社群的建議和意見來進行迭代，您可以點此連結來提交您的意見和建議：
https://github.com/dotnetcore/Magicodes.IE/issues/46
## 說明
本章教程主要說明如何使用Magicodes.IE.Excel進行圖片的匯入匯出。
## 要點
- 配置DTO進行Excel圖片匯出
- 配置DTO進行Excel圖片匯入
## 圖片匯入匯出特性說明
### ExportImageFieldAttribute
+ **Height**： 高度(預設15)
+ **Width**：寬度(預設50)
+ **Alt**：圖片不存在時替換文字
### ImportImageFieldAttribute
+ **ImageDirectory**： 圖片儲存路徑（預設儲存到臨時目錄）
+ **ImportImageTo**：圖片匯出方式（預設Base64），支援的方式如下所示：
```csharp
///
/// 圖片匯入型別
///
public enum ImportImageTo
{
///
/// 匯入到臨時目錄
///
TempFolder,
///
/// 匯入為base64格式
///
Base64
}
```
## 主要步驟
### 1.安裝包Magicodes.IE.Excel
```powershell
Install-Package Magicodes.IE.Excel
```
### 2.使用Magicodes.IE.Excel匯出圖片到Excel
如下述示例程式碼所示，我們需要在圖片屬性上新增**ExportImageFieldAttribute**特性，使用特性的“Width”屬性指定圖片寬度，“Height”屬性指定圖片高度，“Alt”屬性指定替換文字，也就是當圖片不存在時則會顯示此文字：
```csharp
[ExcelExporter(Name = "測試")]
public class ExportTestDataWithPicture
{
[ExporterHeader(DisplayName = "加粗文字", IsBold = true)]
public string Text { get; set; }
[ExporterHeader(DisplayName = "普通文字")] public string Text2 { get; set; }
[ExporterHeader(DisplayName = "忽略", IsIgnore = true)]
public string Text3 { get; set; }
[ExportImageField(Width = 20, Height = 120)]
[ExporterHeader(DisplayName = "圖1")]
public string Img1 { get; set; }
[ExporterHeader(DisplayName = "數值", Format = "#,##0")]
public decimal Number { get; set; }
[ExporterHeader(DisplayName = "名稱", IsAutoFit = true)]
public string Name { get; set; }
///
/// 時間測試
///
/// 將圖片寫入到臨時目錄
///
/// 將圖片寫入到臨時目錄
/// (filePath);
if (import.Exception != null) _testOutputHelper.WriteLine(import.Exception.ToString());
if (import.RowErrors.Count > 0) _testOutputHelper.WriteLine(JsonConvert.SerializeObject(import.RowErrors));
}
```
如下圖所示，Excel中的圖片就會匯入到臨時目錄。值得注意的是：
+ **圖片匯入到臨時目錄之後，如果匯入結果符合業務需要，請立即將圖片移動到正式儲存位置，比如網站目錄、雲端儲存等；**
+ 圖片匯入也支援指定位置，不過不推薦。
#### 將圖片匯入為base64
將圖片匯入為base64僅需設定“ImportImageTo”屬性值為“ImportImageTo.Base64”即可：
```csharp
public class ImportPictureBase64Dto
{
[ImporterHeader(Name = "加粗文字")]
public string Text { get; set; }
[ImporterHeader(Name = "普通文字")]
public string Text2 { get; set; }
///
/// 將圖片匯入為base64（預設為base64）
///
[ImportImageField(ImportImageTo = ImportImageTo.Base64)]
[ImporterHeader(Name = "圖1")]
public string Img1 { get; set; }
[ImporterHeader(Name = "數值")]
public string Number { get; set; }
[ImporterHeader(Name = "名稱")]
public string Name { get; set; }
[ImporterHeader(Name = "日期")]
public DateTime Time { get; set; }
///
/// 將圖片匯入到臨時目錄
///
[ImportImageField(ImportImageTo = ImportImageTo.TempFolder)]
[ImporterHeader(Name = "圖")]
public string Img { get; set; }
}
```
匯入程式碼同上：
```csharp
public async Task ImportPictureBase64_Test()
{
var filePath = Path.Combine(Directory.GetCurrentDirectory(), "TestFiles", "Import", "圖片匯入模板.xlsx");
var import = await Importer.Import(filePath);
}
```
如下圖所示，我們就很方便的得到了圖片的base64編碼的結果：
## Reference
https://github.com/dotnetcore/Magicodes.IE