Sdílet prostřednictvím

Použití generátoru serializátoru Microsoft XML v .NET Core

  • Článek

V tomto kurzu se naučíte, jak používat generátor serializátoru Microsoft XML v aplikaci C# .NET Core. V průběhu tohoto kurzu se naučíte:

  • Vytvoření aplikace v .NET Core
  • Přidání odkazu do balíčku Microsoft.XmlSerializer.Generator
  • Úprava souboru MyApp.csproj a přidání závislostí
  • Přidání třídy a objektu XmlSerializer
  • Sestavení a spuštění aplikace

Stejně jako generátor serializátoru XML (sgen.exe) pro rozhraní .NET Framework je balíček NuGet Microsoft.XmlSerializer.Generator ekvivalentem pro projekty .NET Core a .NET Standard. Vytvoří sestavení serializace XML pro typy obsažené v sestavení ke zlepšení spouštění serializace XML při serializaci nebo de-serializace objekty těchto typů pomocí XmlSerializer.

Požadavky

Pro absolvování tohoto kurzu potřebujete:

Tip

Potřebujete nainstalovat editor kódu? Vyzkoušejte Visual Studio!

Použití generátoru serializátoru Microsoft XML v konzolové aplikaci .NET Core

Následující pokyny ukazují, jak používat generátor serializátoru XML v konzolové aplikaci .NET Core.

Vytvoření konzolové aplikace .NET Core

Otevřete příkazový řádek a vytvořte složku s názvem MyApp. Přejděte do složky, kterou jste vytvořili, a zadejte následující příkaz:

dotnet new console

Přidání odkazu na balíček Microsoft.XmlSerializer.Generator v projektu MyApp

Pomocí příkazu dotnet add package přidejte odkaz do projektu.

Zadejte:

dotnet add package Microsoft.XmlSerializer.Generator -v 1.0.0

Ověření změn v souboru MyApp.csproj po přidání balíčku

Otevřete editor kódu a pusťme se do toho! Pořád pracujeme z adresáře MyApp , ve kterém jsme aplikaci vytvořili.

Otevřete Soubor MyApp.csproj v textovém editoru.

Po spuštění dotnet add package příkazu se do souboru projektu MyApp.csproj přidají následující řádky:

<ItemGroup>
   <PackageReference Include="Microsoft.XmlSerializer.Generator" Version="1.0.0" />
</ItemGroup>

Přidání dalšího oddílu ItemGroup pro podporu nástroje .NET CLI

Za oddíl, který jsme prozkoumali, přidejte následující řádky ItemGroup :

<ItemGroup>
   <DotNetCliToolReference Include="Microsoft.XmlSerializer.Generator" Version="1.0.0" />
</ItemGroup>

Přidání třídy v aplikaci

Otevřete Program.cs v textovém editoru. Přidejte třídu s názvem MyClass v souboru Program.cs.

public class MyClass
{
   public int Value;
}

Vytvoření třídy XmlSerializer pro MyClass

Přidejte do Main následující řádek, který vytvoří XmlSerializer pro MyClass:

var serializer = new System.Xml.Serialization.XmlSerializer(typeof(MyClass));

Sestavení a spuštění aplikace

Stále ve složce MyApp spusťte aplikaci přes dotnet run a automaticky načte a používá předem generované serializátory za běhu.

V okně konzoly zadejte následující příkaz:

dotnet run

Poznámka

dotnet run volání dotnet build , aby se zajistilo sestavení cílů sestavení, a pak volání dotnet <assembly.dll> ke spuštění cílové aplikace.

Důležité

Příkazy a kroky uvedené v tomto kurzu pro spuštění aplikace se používají pouze během doby vývoje. Jakmile budete připraveni k nasazení aplikace, podívejte se na různé strategie nasazení aplikací .NET Core a příkaz dotnet publish .

Pokud vše proběhne úspěšně, vygeneruje se ve výstupní složce sestavení s názvemMyApp.XmlSerializers.dll .

Gratulujeme! Máte právě:

  • Vytvořili jste aplikaci .NET Core.
  • Byl přidán odkaz na balíček Microsoft.XmlSerializer.Generator.
  • Upravili jste soubor MyApp.csproj tak, aby se přidaly závislosti.
  • Přidání třídy a XmlSerializer.
  • Sestavili a spustili aplikaci.

Další přizpůsobení sestavení serializace XML (volitelné)

Přidejte do souboru MyApp.csproj následující kód XML, abyste mohli dále přizpůsobit generování sestavení:

<PropertyGroup>
    <SGenReferences>C:\myfolder\abc.dll;C:\myfolder\def.dll</SGenReferences>
    <SGenTypes>MyApp.MyClass;MyApp.MyClass1</SGenTypes>
    <SGenProxyTypes>false</SGenProxyTypes>
    <SGenVerbose>true</SGenVerbose>
    <SGenKeyFile>mykey.snk</SGenKeyFile>
    <SGenDelaySign>true</SGenDelaySign>
</PropertyGroup>