📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）
| 251行目: | 251行目: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<br> | <br> | ||
上記のクラスを使用する場合は、以下に示すようにインスタンスを生成して、メソッドを実行する。<br> | |||
<syntaxhighlight lang="c#"> | |||
var iniWriter = new IniFileWriter(); | |||
// セクションを追加する | |||
iniWriter.AddSection("新しいセクション"); | |||
// セクション, キー, 値をセット | |||
iniWriter.SetValue("新しいセクション", "新しいキー", "新しい値"); | |||
// INIファイルへ書き込む | |||
await iniWriter.WriteIniFileAsync("sample.ini"); | |||
</syntaxhighlight> | |||
<br><br> | |||
== ini-parserライブラリ == | |||
==== ini-parserライブラリとは ==== | |||
ini-parserライブラリは、C#で開発されたオープンソースのライブラリであり、INIファイルの読み書きを簡単に行うことができる。<br> | |||
このライブラリは、INIファイルの構造を解析して、扱いやすいオブジェクトモデルに変換する機能を提供している。<br> | |||
<br> | |||
ini-parserライブラリの主な特徴として、シンプルで直感的なAPIを持つことが挙げられる。<br> | |||
開発者は、複雑な文字列操作やファイル操作を行うことなく、INIファイルの内容を簡単に操作することができる。<br> | |||
<br> | |||
このライブラリは、セクション、キー、値の概念を自然にサポートしており、INIファイルの階層構造を忠実に表現する。<br> | |||
<br> | |||
ライブラリの中心となるのは、<code>FileIniDataParser</code>クラスである。<br> | |||
このクラスを使用することにより、INIファイルの読み込みと書き込みを行うことができる。<br> | |||
<br> | |||
読み込んだデータは<code>IniData</code>オブジェクトとして表現され、このオブジェクトを通じてINIファイルの内容にアクセスおよび変更することが可能である。<br> | |||
<br> | |||
ini-parserライブラリは、コメントの保持やフォーマットの維持等、INIファイルの構造を尊重する機能も備えている。<br> | |||
これにより、既存のINIファイルを読み込んで変更を加え、元のフォーマットを保ったまま書き出すことができる。<br> | |||
<br> | |||
エラーハンドリングも考慮されており、ファイルの読み込みや書き込み時に発生する可能性のある例外を適切に処理できるようになっている。<br> | |||
また、無効なINIファイルの構造に対しても、可能な限り柔軟に対応するよう設計されている。<br> | |||
<br> | |||
パフォーマンスの面でも、ini-parserライブラリは効率的に動作するよう最適化されている。<br> | |||
大きなINIファイルを扱う場合でも、メモリ使用量を抑えつつ高速に処理を行うことができる。<br> | |||
<br> | |||
さらに、ini-parserライブラリは拡張性も考慮されており、カスタムのパーサーや書き込みロジックを実装することも可能である。<br> | |||
これにより、特殊なフォーマットのINIファイルや、INIファイルに似た独自フォーマットのファイルにも対応することができる。<br> | |||
<br> | |||
ini-parserライブラリを使用することにより、開発者はINIファイルの処理に関する低レベルの詳細に煩わされることなく、アプリケーションのロジックに集中することができる。<br> | |||
シンプルな設定ファイルから複雑な構成ファイルまで、幅広いシナリオでini-parserライブラリは有効なライブラリとなっている。<br> | |||
<br> | |||
==== ini-parserライブラリのインストール ==== | |||
RiderまたはVisual StudioからNuGetを使用して、ini-parserライブラリをインストールする。<br> | |||
* Riderの場合 | |||
*# プロジェクトを開く。 | |||
*# [ツール]メインメニュー - [Nuget] - [ソリューション の Nuget パッケージを管理] (または、[<プロジェクト名> の Nuget パッケージを管理])を選択する。 | |||
*# メイン画面下部にある[パッケージ]タブから <u>ini-parser</u> と入力して検索する。 | |||
*# メイン画面下部の右にある[+]ボタンを押下して、ini-parserライブラリをインストールする。 | |||
*: <br> | |||
* Visual Studioの場合 | |||
*# プロジェクトを開く。 | |||
*# NuGetパッケージマネージャーを開く。 | |||
*#* [ツール]メインメニュー - [NuGetパッケージマネージャー]を選択して、[ソリューションのNuGetパッケージの管理]を選択する。 | |||
*#* または、ソリューションエクスプローラーでプロジェクトを右クリックして、コンテキストメニューから[NuGetパッケージの管理]を選択する。 | |||
*# ini-parserライブラリを検索する。 | |||
*#: NuGetパッケージマネージャーの検索ボックスに <u>ini-parser</u> と入力して検索する。 | |||
*# ini-parserライブラリのインストール | |||
*#: 検索結果からini-parserライブラリを選択して、[インストール]ボタンを押下する。 | |||
*# インストールの確認ダイアログが表示されるので、[OK]ボタンを押下してインストールを完了する。 | |||
*# 参照の確認 | |||
*#: インストールが完了した後、プロジェクトの参照にini-parserライブラリが追加されていることを確認する。 | |||
*: <br> | |||
* パッケージマネージャーコンソールからインストールする場合 | |||
*# プロジェクトを開く。 | |||
*# [表示]メインメニュー - [その他のウィンドウ] - [パッケージマネージャーコンソール]を選択して、パッケージマネージャーコンソールを開く。 | |||
*# パッケージマネージャーコンソールから、ini-parserライブラリをダウンロードしてインストールする。 | |||
*#: <code>Install-Package ini-parser</code> | |||
*# ソリューションエクスプローラーのプロジェクトの参照において、ini-parserライブラリが追加されていることを確認する。 | |||
*: <br> | |||
* <code>dotnet</code>コマンドを使用する場合 | |||
*# ターミナルを開く。 | |||
*# プロジェクトのルートディレクトリに移動する。 | |||
*# ini-parserライブラリをインストールする。 | |||
*#: 最新の安定版をインストールする場合 | |||
*#: <code>dotnet add package ini-parser</code> | |||
*#: <br> | |||
*#: バージョンを指定してインストールする場合 | |||
*#: <code>dotnet add package ini-parser --version <バージョン></code> | |||
*#: <br> | |||
*: <u>※注意</u> | |||
*: <u>プロジェクトがGit等のバージョン管理システムを使用している場合、これらの変更がトラッキングされることを確認すること。</u> | |||
*: <u>プロジェクトを再ビルドして、新しく追加されたパッケージが正しく統合されていることを確認することを推奨する。</u> | |||
<br> | |||
プロジェクトにおいて、ini-parserライブラリを使用する場合は、ソースコードファイルの先頭にusingステートメントを追加する。<br> | |||
<syntaxhighlight lang="c#"> | |||
using IniParser; | |||
using IniParser.Model; | |||
</syntaxhighlight> | |||
<br> | |||
また、大規模なCSVファイルを扱う場合は、ストリーミング処理を使用することを推奨する。<br> | |||
<br> | |||
==== INIファイルの読み込み ==== | |||
<br> | |||
==== INIファイルの書き込み ==== | |||
<br><br> | <br><br> | ||