本教程介紹如何在 C# .NET Core 應用程式中使用 Microsoft XML 序列化程式生成器。 在本教程中可學習:
如何建立 .NET Core 應用
如何添加 Microsoft.XmlSerializer.Generator 包引用
如何編輯 MyApp.csproj,以添加依賴項
如何添加類和 XmlSerializer
如何生成并運作應用程式
正如适用于 .NET Framework 的 Xml Serializer Generator (sgen.exe),Microsoft.XmlSerializer.Generator NuGet 包 是适用于 .NET Core 和 .NET 标準項目的等效項。 它為程式集中包含的類型建立 XML 序列化程式集,進而提高使用 XmlSerializer 序列化或反序列化這些類型對象時,XML 序列化的啟動性能。
先決條件
完成本教程:
.NET Core 2.1 SDK 或更高版本。
最喜愛的代碼編輯器。
提示
需要安裝代碼編輯器? 試用 Visual Studio!
在 .NET Core 控制台應用程式中使用 Microsoft XML 序列化程式生成器
以下說明将展示如何在 .NET Core 控制台應用程式中使用 XML 序列化程式生成器。
建立 .NET Core 控制台應用程式
打開指令提示符,建立一個名為“MyApp”的檔案夾。 導航到建立的檔案夾,并鍵入以下指令:
dotnet new console
在 MyApp 項目中向 Microsoft.XmlSerializer.Generator 包添加引用
使用 dotnet add package 指令在項目中添加引用。
類型:
dotnet add package Microsoft.XmlSerializer.Generator -v 1.0.0
複制
添加包後,驗證對 MyApp.csproj 的更改
打開代碼編輯器并開始操作! 仍從生成了應用的 MyApp 目錄中進行操作。
在文本編輯器中打開 MyApp.csproj。
運作 dotnet add package 指令後,會将以下行添加到 MyApp.csproj 項目檔案中:
<ItemGroup>
<PackageReference Include="Microsoft.XmlSerializer.Generator" Version="1.0.0" />
</ItemGroup>
複制
為 .NET CLI 工具支援添加其他 ItemGroup 部分
在已檢查的 ItemGroup 部分後添加以下行:
<ItemGroup>
<DotNetCliToolReference Include="Microsoft.XmlSerializer.Generator" Version="1.0.0" />
</ItemGroup>
複制
在應用程式中添加類
在文本編輯器中打開 Program.cs。 在 Program.cs 中添加名為“MyClass”的類 。
public class MyClass
{
public int Value;
}
複制
為 MyClass 建立 XmlSerializer
在 Main 中添加以下行,為 MyClass 建立 XmlSerializer:
var serializer = new System.Xml.Serialization.XmlSerializer(typeof(MyClass));
複制
編譯和運作應用程式
還是在 MyApp 檔案夾中,通過 dotnet run 運作應用程式,它會在運作時自動加載和使用預生成的序列化程式。
在控制台視窗中鍵入以下指令:
dotnet run
備注
dotnet run 調用 dotnet build 來確定已生成要生成的目标,然後調用 dotnet <assembly.dll> 運作目标應用程式。
重要
本教程中用來運作應用程式的指令和步驟僅用于開發過程。 準備好部署應用後,檢視适用于 .NET Core 應用的不同部署政策和 dotnet publish 指令。
如果一切順利,則會在輸出檔案夾中生成名為“MyApp.XmlSerializers.dll”的程式集。
祝賀你! 你剛才已完成:
建立 .NET Core 應用。
向 Microsoft.XmlSerializer.Generator 包中添加引用。
編輯 MyApp.csproj 以添加依賴項。
添加類和 XmlSerializer。
生成和運作應用程式。
相關資源
XML 序列化簡介
如何使用 XmlSerializer 進行序列化 (C#)
如何:使用 XmlSerializer (Visual Basic) 進行序列化