NSwag は C# で API スペックの生成にどのように役立ちますか？

NSwag は .NET Core プロジェクトから Swagger または OpenAPI ドキュメントとして知られる API スペックを自動的に生成できます。これにより API ドキュメントが常にコードベースと同期されます。

Swagger 仕様を PDF ドキュメントに変換するプロセスは何ですか？

Swagger 仕様を PDF ドキュメントに変換するには、IronPDF を使用します。まず、NSwag を使用して Swagger 仕様を生成し、その仕様の HTML コンテンツを IronPDF を使用して高品質の PDF に変換します。

.NET プロジェクトに NSwag を統合する方法は？

.NET プロジェクトに NSwag を統合するには、NuGet を介して NSwag ライブラリをインストールし、ビルドプロセス中に Swagger 仕様を生成するように構成し、その生成された仕様を文書化やコード生成に使用します。

NSwag は Swagger 仕様からクライアントコードとサーバーコードを生成できますか？

はい、NSwag は C#、Java、TypeScript などの言語でクライアントコードを生成し、ASP.NET Core コントローラーのようなサーバー・サイドコードも生成できます。

IronPDF は API ドキュメントのワークフローをどのように向上させますか？

IronPDF は HTML ベースの API ドキュメンテーションを専門的で共有可能な PDF ドキュメントに変換することにより、どこでもアクセス可能な情報を提供し、API ドキュメンテーションワークフローを向上させます。

Visual Studio プロジェクトで IronPDF を使用するために必要な手順は何ですか？

Visual Studio プロジェクトで IronPDF を使用するには、NuGet パッケージマネージャーで IronPDF を検索して「インストール」をクリックするか、パッケージマネージャーコンソールで Install-Package IronPDF コマンドを使用してインストールします。

NSwag を使用してインタラクティブな API ドキュメンテーションをどのように生成できますか？

NSwag はブラウザ内で API エンドポイントを直接探索およびテストするためのインターフェイスを提供する Swagger UI を生成することで、インタラクティブな API ドキュメンテーションを生成できます。

NSwag を API ドキュメンテーションに使用する利点は何ですか？

NSwag は API ドキュメンテーションの自動生成を行い、コードベースと常に一致するように保ちます。インタラクティブなドキュメンテーションとクライアント・サイドコードの作成をサポートし、開発プロセスを効率化します。

IronPDF は HTML コンテンツをどのようにして PDF に変換しますか？

IronPDF は CSS と JavaScript を含む HTML コンテンツを PDF 形式に変換するため、そのレンダリングエンジンを使用してウェブベースのコンテンツから正確かつオフライン対応のドキュメントを作成します。

Where can I find more information about IronPDF licensing?

For further information about IronPDF licensing, including pricing and terms, visit the [IronPDF licensing information page](https://ironpdf.com/licensing/).

C# PDFライブラリ

Explore IronPDF 無料トライアル

HTML から PDF へ

Online Demo すべてのコード例を見る

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

開発者向けアップデート

Nswag C#（開発者向けの動作方法）

Jacob Mellor

Updated: 2026年4月21日

API は、さまざまなソフトウェアシステムやコンポーネント間のコミュニケーションを促進するため、今日のソフトウェア開発環境において不可欠です。開発者が API を効率的に利用するためには、徹底的で理解しやすいドキュメントが必要です。 C# API ドキュメントのワークフローを改善できる効果的なツールには、NSwag C# と IronPDF があります。この投稿では、.NET Core を使用して API 仕様を生成し、これらの仕様を IronPDF を使用して高品質の PDF ドキュメントにする方法を紹介します。

How to Use NSwag in C#

Swagger UI を使用して RESTful Web API を作成します。
C# コンソールアプリケーションを作成します。
NSwag ライブラリをインストールします。
名前空間をインポートし、オブジェクトを作成します。
Swagger JSON を C# コードに変換します。
コードを実行し、結果を表示します。

NSwag の理解

NSwag は、ASP.NET Web API、ASP.NET Core、または他の .NET Frameworkを使用して構築された API のために Swagger 仕様、すなわち OpenAPI ドキュメントを作成するプロセスを容易にするために作成された .NET の Swagger ツールチェーンです。

NSwag の特徴

Swagger 仕様の生成

NSwag は、コントローラー、モデル、および .NET アセンブリを使用して Swagger 仕様を自動的に生成できます。 NSwag は API コードの構造を検査することで、API エンドポイント、リクエスト/レスポンス形式、認証手法などをカバーする包括的なドキュメントを生成します。

.NET プロジェクトへの統合

開発者は、NSwag を .NET プロジェクトに統合することで、開発プロセスに Swagger 生成を簡単に組み込むことができます。開発者は、NSwag を .NET Core プロジェクトに追加することで、コードベースとともにドキュメントが更新されることを確認できます。これにより、プロジェクトが構築されるたびに Swagger 仕様が自動的に生成されます。

カスタマイズと拡張

NSwag が提供する幅広いカスタマイズオプションにより、開発者は生成された Swagger 仕様を簡単に独自のニーズに合わせて調整できます。開発者は、構成設定や注釈を通じて、生成されたドキュメントの多くのコンポーネント（応答コード、パラメータの説明、ルート命名規則など）を管理できます。

NSwag の始め方

NSwagをC#コンソールアプリで設定する

NSwag ベースクラスライブラリには、コア、注釈、コード生成用の名前空間が含まれており、NuGet からのインストールで入手可能です。 NSwag を C# アプリケーションに統合してコードと Swagger 仕様を生成する方法、および NSwag が開発プロセスの効率をどのように向上させるか。

NSwag C# (開発者向けの作動方法): 図1 - Visual Studio パッケージマネージャで NSwag を検索し、インストールする

Windows コンソールとフォームへの NSwag の実装

自動化されたクライアント生成を通じて、開発者は NSwag を Windows デスクトップアプリケーションに統合することで、デスクトップアプリ内から API に直接アクセスするコードを効率的に生成できます。オンラインサービスや RESTful API と通信するデスクトップアプリを開発する際にとても役に立ちます。

NSwag は、内部 API の API ドキュメントや外部 API を利用するためのクライアントコードを生成するために Web アプリケーションで使用できます。これにより、開発者はアプリケーションのフロントエンドとバックエンドコンポーネントを一貫させることができます。

NSwag C#の例

以下は、NSwag を使用して C# クライアントコードを生成する方法を示すコード例です。

using NSwag.CodeGeneration.CSharp;
using NSwag;
using System.Reflection;
using System.CodeDom.Compiler;
using Microsoft.CodeAnalysis;
using System.Net.Http;
using System.IO;
using System.Collections.Generic;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        using (var wclient = new System.Net.WebClient())
        {
            // Create JSON file data from the Swagger .NET Core web API
            var document = await OpenApiDocument.FromJsonAsync(wclient.DownloadString("http://localhost:5013/swagger/v1/swagger.json"));
            var settings = new CSharpClientGeneratorSettings
            {
                ClassName = "Weather",
                CSharpGeneratorSettings = { Namespace = "Demo" }
            };

            var generator = new CSharpClientGenerator(document, settings);
            var code = generator.GenerateFile();
            var assembly = CompileCode(code);
            var clientType = assembly.GetType("Demo.WeatherClient"); // Replace with your actual client class name
            using (var httpClient = new HttpClient())
            {
                var client = (IApiClient)Activator.CreateInstance(clientType, httpClient);
                var result = await client.GetWeatherForecastAsync();
                foreach (var item in result)
                {
                    Console.WriteLine($"Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}");
                }
            }
        }
    }

    static Assembly CompileCode(string code)
    {
        using (var memoryStream = new MemoryStream())
        {
            var assemblyPath = Path.GetDirectoryName(typeof(object).Assembly.Location);
            var references = new List<MetadataReference>
            {
                MetadataReference.CreateFromFile(typeof(object).GetTypeInfo().Assembly.Location),
                MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "Microsoft.AspNetCore.Mvc.dll")),
                MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "System.Private.CoreLib.dll"))
            };

            var compilation = Microsoft.CodeAnalysis.CSharp.CSharpCompilation.Create("ApiClient")
                .WithOptions(new Microsoft.CodeAnalysis.CSharp.CSharpCompilationOptions(OutputKind.DynamicallyLinkedLibrary))
                .AddReferences(references)
                .AddSyntaxTrees(Microsoft.CodeAnalysis.CSharp.SyntaxFactory.ParseSyntaxTree(code));

            var emitResult = compilation.Emit(memoryStream);
            if (!emitResult.Success)
            {
                Console.WriteLine("Compilation errors:");
                foreach (var diagnostic in emitResult.Diagnostics)
                {
                    Console.WriteLine(diagnostic);
                }
                return null;
            }
            memoryStream.Seek(0, SeekOrigin.Begin);
            return Assembly.Load(memoryStream.ToArray());
        }
    }

    public interface IApiClient
    {
        // Replace with your actual method name and return type
        Task<List<WeatherForecast>> GetWeatherForecastAsync();
    }

    public class WeatherForecast
    {
        public DateTime Date { get; set; }
        public int TemperatureC { get; set; }
        public int TemperatureF { get; set; }
        public string Summary { get; set; }
    }
}

using NSwag.CodeGeneration.CSharp;
using NSwag;
using System.Reflection;
using System.CodeDom.Compiler;
using Microsoft.CodeAnalysis;
using System.Net.Http;
using System.IO;
using System.Collections.Generic;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        using (var wclient = new System.Net.WebClient())
        {
            // Create JSON file data from the Swagger .NET Core web API
            var document = await OpenApiDocument.FromJsonAsync(wclient.DownloadString("http://localhost:5013/swagger/v1/swagger.json"));
            var settings = new CSharpClientGeneratorSettings
            {
                ClassName = "Weather",
                CSharpGeneratorSettings = { Namespace = "Demo" }
            };

            var generator = new CSharpClientGenerator(document, settings);
            var code = generator.GenerateFile();
            var assembly = CompileCode(code);
            var clientType = assembly.GetType("Demo.WeatherClient"); // Replace with your actual client class name
            using (var httpClient = new HttpClient())
            {
                var client = (IApiClient)Activator.CreateInstance(clientType, httpClient);
                var result = await client.GetWeatherForecastAsync();
                foreach (var item in result)
                {
                    Console.WriteLine($"Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}");
                }
            }
        }
    }

    static Assembly CompileCode(string code)
    {
        using (var memoryStream = new MemoryStream())
        {
            var assemblyPath = Path.GetDirectoryName(typeof(object).Assembly.Location);
            var references = new List<MetadataReference>
            {
                MetadataReference.CreateFromFile(typeof(object).GetTypeInfo().Assembly.Location),
                MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "Microsoft.AspNetCore.Mvc.dll")),
                MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "System.Private.CoreLib.dll"))
            };

            var compilation = Microsoft.CodeAnalysis.CSharp.CSharpCompilation.Create("ApiClient")
                .WithOptions(new Microsoft.CodeAnalysis.CSharp.CSharpCompilationOptions(OutputKind.DynamicallyLinkedLibrary))
                .AddReferences(references)
                .AddSyntaxTrees(Microsoft.CodeAnalysis.CSharp.SyntaxFactory.ParseSyntaxTree(code));

            var emitResult = compilation.Emit(memoryStream);
            if (!emitResult.Success)
            {
                Console.WriteLine("Compilation errors:");
                foreach (var diagnostic in emitResult.Diagnostics)
                {
                    Console.WriteLine(diagnostic);
                }
                return null;
            }
            memoryStream.Seek(0, SeekOrigin.Begin);
            return Assembly.Load(memoryStream.ToArray());
        }
    }

    public interface IApiClient
    {
        // Replace with your actual method name and return type
        Task<List<WeatherForecast>> GetWeatherForecastAsync();
    }

    public class WeatherForecast
    {
        public DateTime Date { get; set; }
        public int TemperatureC { get; set; }
        public int TemperatureF { get; set; }
        public string Summary { get; set; }
    }
}

Imports NSwag.CodeGeneration.CSharp
Imports NSwag
Imports System.Reflection
Imports System.CodeDom.Compiler
Imports Microsoft.CodeAnalysis
Imports System.Net.Http
Imports System.IO
Imports System.Collections.Generic
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		Using wclient = New System.Net.WebClient()
			' Create JSON file data from the Swagger .NET Core web API
			Dim document = Await OpenApiDocument.FromJsonAsync(wclient.DownloadString("http://localhost:5013/swagger/v1/swagger.json"))
			Dim settings = New CSharpClientGeneratorSettings With {
				.ClassName = "Weather",
				.CSharpGeneratorSettings = { [Namespace] = "Demo" }
			}

			Dim generator = New CSharpClientGenerator(document, settings)
			Dim code = generator.GenerateFile()
			Dim assembly = CompileCode(code)
			Dim clientType = assembly.GetType("Demo.WeatherClient") ' Replace with your actual client class name
			Using httpClient As New HttpClient()
				Dim client = DirectCast(Activator.CreateInstance(clientType, httpClient), IApiClient)
				Dim result = Await client.GetWeatherForecastAsync()
				For Each item In result
					Console.WriteLine($"Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}")
				Next item
			End Using
		End Using
	End Function

	Private Shared Function CompileCode(ByVal code As String) As System.Reflection.Assembly
		Using memoryStream As New MemoryStream()
			Dim assemblyPath = Path.GetDirectoryName(GetType(Object).Assembly.Location)
			Dim references = New List(Of MetadataReference) From {MetadataReference.CreateFromFile(GetType(Object).GetTypeInfo().Assembly.Location), MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "Microsoft.AspNetCore.Mvc.dll")), MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "System.Private.CoreLib.dll"))}

			Dim compilation = Microsoft.CodeAnalysis.CSharp.CSharpCompilation.Create("ApiClient").WithOptions(New Microsoft.CodeAnalysis.CSharp.CSharpCompilationOptions(OutputKind.DynamicallyLinkedLibrary)).AddReferences(references).AddSyntaxTrees(Microsoft.CodeAnalysis.CSharp.SyntaxFactory.ParseSyntaxTree(code))

			Dim emitResult = compilation.Emit(memoryStream)
			If Not emitResult.Success Then
				Console.WriteLine("Compilation errors:")
				For Each diagnostic In emitResult.Diagnostics
					Console.WriteLine(diagnostic)
				Next diagnostic
				Return Nothing
			End If
			memoryStream.Seek(0, SeekOrigin.Begin)
			Return System.Reflection.Assembly.Load(memoryStream.ToArray())
		End Using
	End Function

	Public Interface IApiClient
		' Replace with your actual method name and return type
		Function GetWeatherForecastAsync() As Task(Of List(Of WeatherForecast))
	End Interface

	Public Class WeatherForecast
		Public Property [Date]() As DateTime
		Public Property TemperatureC() As Integer
		Public Property TemperatureF() As Integer
		Public Property Summary() As String
	End Class
End Class

Imports NSwag.CodeGeneration.CSharp
Imports NSwag
Imports System.Reflection
Imports System.CodeDom.Compiler
Imports Microsoft.CodeAnalysis
Imports System.Net.Http
Imports System.IO
Imports System.Collections.Generic
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		Using wclient = New System.Net.WebClient()
			' Create JSON file data from the Swagger .NET Core web API
			Dim document = Await OpenApiDocument.FromJsonAsync(wclient.DownloadString("http://localhost:5013/swagger/v1/swagger.json"))
			Dim settings = New CSharpClientGeneratorSettings With {
				.ClassName = "Weather",
				.CSharpGeneratorSettings = { [Namespace] = "Demo" }
			}

			Dim generator = New CSharpClientGenerator(document, settings)
			Dim code = generator.GenerateFile()
			Dim assembly = CompileCode(code)
			Dim clientType = assembly.GetType("Demo.WeatherClient") ' Replace with your actual client class name
			Using httpClient As New HttpClient()
				Dim client = DirectCast(Activator.CreateInstance(clientType, httpClient), IApiClient)
				Dim result = Await client.GetWeatherForecastAsync()
				For Each item In result
					Console.WriteLine($"Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}")
				Next item
			End Using
		End Using
	End Function

	Private Shared Function CompileCode(ByVal code As String) As System.Reflection.Assembly
		Using memoryStream As New MemoryStream()
			Dim assemblyPath = Path.GetDirectoryName(GetType(Object).Assembly.Location)
			Dim references = New List(Of MetadataReference) From {MetadataReference.CreateFromFile(GetType(Object).GetTypeInfo().Assembly.Location), MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "Microsoft.AspNetCore.Mvc.dll")), MetadataReference.CreateFromFile(Path.Combine(assemblyPath, "System.Private.CoreLib.dll"))}

			Dim compilation = Microsoft.CodeAnalysis.CSharp.CSharpCompilation.Create("ApiClient").WithOptions(New Microsoft.CodeAnalysis.CSharp.CSharpCompilationOptions(OutputKind.DynamicallyLinkedLibrary)).AddReferences(references).AddSyntaxTrees(Microsoft.CodeAnalysis.CSharp.SyntaxFactory.ParseSyntaxTree(code))

			Dim emitResult = compilation.Emit(memoryStream)
			If Not emitResult.Success Then
				Console.WriteLine("Compilation errors:")
				For Each diagnostic In emitResult.Diagnostics
					Console.WriteLine(diagnostic)
				Next diagnostic
				Return Nothing
			End If
			memoryStream.Seek(0, SeekOrigin.Begin)
			Return System.Reflection.Assembly.Load(memoryStream.ToArray())
		End Using
	End Function

	Public Interface IApiClient
		' Replace with your actual method name and return type
		Function GetWeatherForecastAsync() As Task(Of List(Of WeatherForecast))
	End Interface

	Public Class WeatherForecast
		Public Property [Date]() As DateTime
		Public Property TemperatureC() As Integer
		Public Property TemperatureF() As Integer
		Public Property Summary() As String
	End Class
End Class

使用したいAPIのために、Swagger仕様のURLを指定します（swaggerUrl）。次に、生成および実行されるクライアントコードを DLL アセンブリに定義します。 FromJsonAsyncを用います。生成されたクライアントコードを変更するには、コード生成器の設定を調整します（CSharpClientGeneratorSettings）。この例では、生成されたクライアントコードのクラス名と名前空間を指定します。

ロードされたSwaggerドキュメントから、CSharpClientGeneratorのインスタンスを構築し、それを使用してクライアントコードを生成します。作成されたクライアントコードは指定された出力パスに保存されます。手続き中に発生する可能性のある例外やエラーに対応し、関連する通知をコンソールに表示します。

NSwag C# (開発者向けの作動方法): 図2 - 上記のコードからのコンソール出力

NSwag の操作

クライアントコードの生成

NSwag は Swagger 仕様を使用して、Java、TypeScript、C# など多くの言語でクライアントコードを生成できます。これにより、開発者は API を簡単にアプリケーションで利用することができます。

サーバーコードの生成

Swagger 仕様を基にして、NSwag は ASP.NET Core コントローラーなどのサーバーコードも生成できます。これは API 実装のためのサーバーサイドコードを迅速にスキャフォールディングするのに役立ちます。

インタラクティブな API ドキュメントの生成

既存の Swagger 仕様を基にして、NSwag は Swagger UI のようなインタラクティブな API ドキュメントを生成できます。このドキュメントは API エンドポイントを探検しテストするための使いやすいインターフェースを提供します。

プロキシクラスの生成

SOAP ベースの API と統合するために、NSwag はプロキシクラスを生成できます。これにより、プログラマーは生成されたクライアントコードを使用してアプリケーション内から SOAP サービスにアクセスできます。

Swagger 仕様の検証

NSwag は Swagger 仕様が OpenAPI/Swagger 標準に従っていることを確認するために検証することが可能です。これにより API ドキュメント内のエラーや不一致を見つけやすくなります。

NSwag と IronPDF の統合

NSwag を IronPDF と統合することで、両技術の利点を活用して API ドキュメントのワークフローが改善されます。開発者は、NSwag を使用して Swagger 仕様を生成し、IronPDF を使用してそれらを PDF に変換することによって、オフラインでも利用可能で共有しやすい .NET Web API ドキュメントを作成できます。統合プロセスは以下の手順で行います。

IronPDF は HTML から PDF への変換に秀でており、元のレイアウトとスタイルを正確に保存します。これは、レポート、請求書、ドキュメントなどの Web ベースのコンテンツから PDF を作成するのに最適です。 HTML ファイル、URL、または生の HTML 文字列のサポートにより、IronPDF は高品質な PDF ドキュメントを簡単に生成します。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

IronPDFのインストール

Visual Studio プロジェクトを開始します。
"ツール">"NuGet パッケージマネージャー">"パッケージマネージャーコンソール"を選択します。
コマンドプロンプトを開き、パッケージマネージャーコンソールで次のコマンドを入力します。

PM > Install-Package IronPdf

Install-Package IronPdf

または、ソリューションの NuGet パッケージマネージャーを使用して IronPDF をインストールできます。
検索結果から IronPDF パッケージを探して選択し、インストールオプションをクリックしてください。 Visual Studio がダウンロードとインストールを代行します。

NSwag C# (How It Works For Developers): Figure 3 - Install IronPDF using the Manage NuGet Package for Solution by searching "IronPDF" in the search bar of NuGet Package Manager, then select the project and click on the Install button.

NuGet が IronPDF パッケージとプロジェクトに必要な依存関係をインストールします。
インストール後、IronPDF はプロジェクトで利用できるようになります。

NuGetウェブサイトからのインストール

IronPDF の機能、互換性、およびダウンロードに関する詳細情報については、NuGet 上の IronPDF ページをご覧ください。

DLLを利用したインストール

また、DLL ファイルを使用して IronPDF をプロジェクトに直接組み込むこともできます。DLL を含む ZIP ファイルをダウンロードするには、IronPDF ダウンロードリンクをクリックしてください。ファイルを解凍してプロジェクトに DLL を追加してください。

ロジックを実装する

NSwag を利用することで、開発者は IronPDF と結合したCodeGeneration.CSharpを使用して、API ドキュメントとクライアントコードをより迅速に作成できます。統合ワークフローは以下の手順を含みます。

クライアントコードの生成: Swagger スペックから C# クライアントコードを作成するには、NSwag.CodeGeneration.CSharpを使用します。このステップでは、API エンドポイントとの通信のためのクライアントクラスとメソッドの生成が自動化されます。
NSwagを利用してデータを取得: Swagger スペックから JSON ドキュメントを生成するには、CodeGeneration.CSharpを使用します。この段階では、リクエスト/レスポンス形式、認証方法、API クライアントエンドポイントを人間が理解できるドキュメントとして作成します。
JSON から PDF への変換: IronPDF を使用して、生成されたコードの結果を PDF ドキュメントに変換します。この段階では、HTML テキストを共有および配布可能な洗練された PDF ドキュメントに変換します。
PDF ドキュメントの改善: ヘッダー、フッター、透かし、またはユニークなブランドなどのコンテンツを IronPDF を使用して PDF ドキュメントに追加します。このステージでは、開発者は自身の好みに合わせて PDF ドキュメントの外観とブランディングをカスタマイズできます。

using IronPdf;
using System.Text;
using System.Collections.Generic;

StringBuilder sb = new StringBuilder();

foreach (var item in result)
{
    sb.Append($"<p>Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}</p>");
}

var renderer = new HtmlToPdf();
var pdf = renderer.RenderHtmlAsPdf(sb.ToString());
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF generated successfully!");
Console.ReadKey();

using IronPdf;
using System.Text;
using System.Collections.Generic;

StringBuilder sb = new StringBuilder();

foreach (var item in result)
{
    sb.Append($"<p>Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}</p>");
}

var renderer = new HtmlToPdf();
var pdf = renderer.RenderHtmlAsPdf(sb.ToString());
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF generated successfully!");
Console.ReadKey();

Imports IronPdf
Imports System.Text
Imports System.Collections.Generic

Private sb As New StringBuilder()

For Each item In result
	sb.Append($"<p>Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}</p>")
Next item

Dim renderer = New HtmlToPdf()
Dim pdf = renderer.RenderHtmlAsPdf(sb.ToString())
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF generated successfully!")
Console.ReadKey()

Imports IronPdf
Imports System.Text
Imports System.Collections.Generic

Private sb As New StringBuilder()

For Each item In result
	sb.Append($"<p>Date: {item.Date} F: {item.TemperatureF} C: {item.TemperatureC} Summary: {item.Summary}</p>")
Next item

Dim renderer = New HtmlToPdf()
Dim pdf = renderer.RenderHtmlAsPdf(sb.ToString())
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF generated successfully!")
Console.ReadKey()

上記のコードは、結果オブジェクトから取得したデータにアクセスし、Summaryのフィールドをループ内で段落に追加します。その後、PDFの出力ファイルパスを指定し、PDFの生成が成功したことをユーザーに通知します。

上記コードの結果は以下です。

NSwag C# (開発者向けの作動方法): 図4 - 上記のコードからの出力例

結論

CodeGeneration NSwag テクノロジー（CSharp や IronPDF を含む）は、クライアントコード生成と API ドキュメント化のプロセスを効率化するために優れています。開発者は、これらのツールを C# アプリケーションに統合することで、API ドリブンソリューションの作成をスピードアップし、API ドキュメントの作成を自動化し、プロフェッショナルな外観の PDF 出版物を生成できます。 IronPDFを用いたNSwag.CodeGeneration.CSharpは、APIsの効率的なドキュメンテーションとC#でのクライアントコード生成に完全なソリューションを提供します。これはデスクトップ、ウェブ、またはクラウドベースのアプリを開発しているかに関わらず有効です。

Lite バンドルには、永久ライセンス、1 年間のソフトウェアメンテナンス、およびライブラリのアップグレードが含まれています。 IronPDF は、再配布および期間に制限のある無料のライセンスを提供しています。ユーザーは、試用期間中にウィーターマークを視認せずにソリューションを評価できます。価格とライセンスに関する追加情報は、IronPDFのライセンス情報をご覧ください。 Iron Software の製品ライブラリに関する詳細については、Iron Software ライブラリのページに移動してください。

Jacob Mellor

今すぐエンジニアリングチームとチャット

最高技術責任者（CTO）

ジェイコブ・メラーはIron Softwareの最高技術責任者（CTO）であり、C# PDFテクノロジーを開拓する先見的なエンジニアです。Iron Softwareのコアコードベースを支えるオリジナル開発者として、彼は創業以来、会社の製品アーキテクチャを形成し、CEOのCameron Rimingtonとともに、会社をNASA、Tesla、および世界的な政府機関にサービスを提供する50人以上の会社に変えました。1999年にロンドンで最初のソフトウェアビジネスを開業し、2005年に最初 for .NETコンポーネントを作成した後、Microsoftのエコシステム全体で複雑な問題を解決することを専門としました。