知識マップ: CSVは「ただのテキスト」ではない ── C#業務アプリのCSV実務(文字コード・Excel互換・インジェクション対策)

記事「CSVは「ただのテキスト」ではない ── C#業務アプリのCSV実務(文字コード・Excel互換・インジェクション対策)」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

この記事は業務アプリでのCSV入出力を、事実上の標準であるRFC 4180を軸に整理します。String.Splitによる自作パースはフィールド内のカンマや改行を処理できないため推奨されず、.NET標準のTextFieldParserやライブラリのCsvHelperがその代替として位置づけられます。文字コードはBOM付きUTF-8がExcelでの文字化けを防ぐ一方、システム間連携ではBOMなしUTF-8が使われ、.NET(Core)でShift_JISを扱うにはCodePagesEncodingProviderの登録が前提になります。ExcelはCSVの値を数値や日付として解釈するため先頭ゼロ落ちや日付化が起き、これを避けたい場合はxlsx出力が有効です。ユーザー入力を出力するアプリでは、数式解釈を悪用するCSVインジェクションへの対策として先頭文字の無害化が必要になります。

flowchart LR
    accTitle: CSVファイル処理の知識マップ
    accDescr: CSVがRFC 4180を前提とすること、Split自作パースが非推奨でTextFieldParserやCsvHelperが代替になること、BOMの有無がExcelでの文字化けとCSVインジェクション対策・xlsx出力の使い分けに関わることを示す図
    csv["CSV(カンマ区切り値)"]
    textfieldparser["TextFieldParser"]
    rfc_4180["RFC 4180"]
    string_split_csv_parsing["String.Split(',')による自作CSVパース"]
    csvhelper["CsvHelper"]
    excel["Excel"]
    excel_csv_value_interpretation["ExcelによるCSV値の解釈(先頭ゼロ落ち・日付化・指数表記)"]
    xlsx_output["xlsx出力"]
    csv_injection["CSVインジェクション"]
    csv_injection_sanitization["数式先頭文字の無害化(CSVインジェクション対策)"]
    shift_jis["Shift_JIS"]
    codepages_encoding_provider["CodePagesEncodingProvider"]
    dotnet[".NET(Core以降)"]
    bom["BOM(Byte Order Mark)"]
    utf8_bom_encoded["BOM付きUTF-8"]
    utf8_no_bom["BOMなしUTF-8"]
    csv_mojibake["CSVの文字化け"]
    utf8encoding_class["UTF8Encodingクラス"]
    streaming_csv_read["CSVのストリーミング読み込み"]
    invariant_culture["CultureInfo.InvariantCulture"]
    csv -.->|"前提とする"| rfc_4180
    string_split_csv_parsing -->|"用いるのは非推奨"| csv
    textfieldparser -->|"実装を担う"| rfc_4180
    textfieldparser -->|"推奨される対応"| csv
    csvhelper -.->|"推奨される対応"| csv
    csvhelper -->|"実装を担う"| rfc_4180
    csvhelper -.->|"の後継"| textfieldparser
    excel -->|"原因になり得る"| excel_csv_value_interpretation
    xlsx_output -.->|"防止する"| excel_csv_value_interpretation
    xlsx_output -.->|"推奨される対応"| excel
    csv -.->|"原因になり得る"| csv_injection
    csv_injection_sanitization -->|"軽減する"| csv_injection
    shift_jis -.->|"前提とする"| codepages_encoding_provider
    dotnet -.->|"前提とする"| codepages_encoding_provider
    bom -.->|"に保存される"| csv
    utf8_bom_encoded -->|"推奨される対応"| excel
    utf8_no_bom -.->|"用いるのは非推奨"| excel
    utf8_no_bom -.->|"原因になり得る"| csv_mojibake
    utf8_bom_encoded -->|"防止する"| csv_mojibake
    bom -->|"で構成できる"| utf8encoding_class
    textfieldparser -->|"推奨される対応"| streaming_csv_read
    invariant_culture -->|"推奨される対応"| csv
    excel -->|"利用する"| csv
    csv -.->|"利用する"| shift_jis

概念間の関係(全24件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

CSV(カンマ区切り値)はRFC 4180を前提とします。CSVはRFC 4180を事実上の標準仕様として前提とし、区切り・引用符・エスケープの規則が定義される。ただしRFC 4180はあくまで事実上の標準であり、改行がLFのみ・引用符処理をしない・区切りがタブやセミコロンなど、現実のCSVには準拠しない方言も多く存在する / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
String.Split(',')による自作CSVパースをCSV(カンマ区切り値)に用いることは推奨されません。String.Split(',')はフィールド内のカンマ・改行・引用符を処理できず仕様上壊れるため、CSVの読み込みには使うべきでない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
TextFieldParserはRFC 4180の実装を担います。TextFieldParserはHasFieldsEnclosedInQuotesによりRFC 4180相当の引用符処理を実装する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
TextFieldParserはCSV(カンマ区切り値)に対する本記事の推奨です。.NET標準の範囲でCSVを正しく読み込む手段として、TextFieldParserの利用が推奨される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
CsvHelperはCSV(カンマ区切り値)に対する本記事の推奨です。列とオブジェクトのマッピング・型変換・大量データの性能まで必要な場合は、CsvHelperの導入が推奨される / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
CsvHelperはRFC 4180の実装を担います。CsvHelperはRFC 4180準拠を明示的に掲げている / 確度: 確立した関係 / 確認日: 2026-08-01 出典
CsvHelperはTextFieldParserの後継に当たります。TextFieldParserでstring[]を受けて自前で型変換している段階を超えたら、CsvHelperが移行先の第一候補になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
ExcelはExcelによるCSV値の解釈(先頭ゼロ落ち・日付化・指数表記)の原因になることがあります。ExcelはCSVを開くときに値を数値や日付として解釈するため、先頭ゼロ落ち・日付化・指数表記の原因になることがある / 確度: 確立した関係 / 確認日: 2026-08-01 出典
xlsx出力はExcelによるCSV値の解釈(先頭ゼロ落ち・日付化・指数表記)を防ぎます。xlsxはセルの型と書式を出力側で制御できるため、電話番号や商品コードのような列を明示的に文字列型で書き出せば、先頭ゼロ落ちや日付化は起きない。数値型のまま書けばxlsxでも先頭ゼロは失われる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
xlsx出力はExcelに対する本記事の推奨です。人がExcelで見る・印刷することが主目的なら、CSVではなくxlsx出力が推奨される / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
CSV(カンマ区切り値)はCSVインジェクションの原因になることがあります。ユーザーが入力した値をCSVに出力してExcelで開かせるアプリは、CSVインジェクションという攻撃経路を持つことがある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
数式先頭文字の無害化(CSVインジェクション対策)はCSVインジェクションを軽減します。数式として解釈されうる先頭文字にシングルクォートを付けて無害化することで、CSVインジェクションを軽減できる。ただし危険な先頭文字の一覧は表計算ソフトの実装・バージョンによって変わりうるため、既知の文字を列挙するだけの無害化では想定漏れが残り得る / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Shift_JISはCodePagesEncodingProviderを前提とします。.NET(Core)でShift_JISを扱う場合、Encoding.GetEncoding("shift_jis") を成功させるには、CodePagesEncodingProviderをRegisterProviderで登録する必要がある。この前提は.NET(Core)側の実装事情によるものであり、Shift_JISという文字コード自体が一般にCodePagesEncodingProviderを必要とするわけではない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
.NET(Core以降)はCodePagesEncodingProviderを前提とします。.NET(Core)は既定ではASCII・ISO-8859-1・Unicode系しかサポートしないため、コードページエンコーディングを使うにはCodePagesEncodingProviderの登録が必要になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
BOM(Byte Order Mark)はCSV(カンマ区切り値)に保存されます。BOMをCSVファイルに含める場合、CSVファイル先頭の3バイト(UTF-8ならEF BB BF)として保存される / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
BOM付きUTF-8はExcelに対する本記事の推奨です。人がExcelでダブルクリックして開くCSVは、BOM付きUTF-8にするのが現在の無難な選択とされる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
BOMなしUTF-8をExcelに用いることは推奨されません。BOMなしUTF-8のダブルクリックでの自動判別は、Excelのバージョン・OSの地域設定に左右され常に成功するとは公式に案内されていない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
BOMなしUTF-8はCSVの文字化けの原因になることがあります。BOMなしUTF-8のCSVをダブルクリックで開くと、環境によってはANSIとして誤認され文字化けの原因になることがある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
BOM付きUTF-8はCSVの文字化けを防ぎます。BOM付きUTF-8であれば通常どおりUTF-8として認識されるため、文字コードの誤認による文字化けを防げる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
BOM(Byte Order Mark)はUTF8Encodingクラスで構成できます。BOMを出力するかどうかは、UTF8Encodingクラスのコンストラクター引数encoderShouldEmitUTF8Identifierで構成できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
TextFieldParserはCSVのストリーミング読み込みに対する本記事の推奨です。TextFieldParserはファイルパスから直接読み込めるため、引用符内の改行を許す仕様のCSVでもファイル全体をメモリに載せずに処理できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
CultureInfo.InvariantCultureはCSV(カンマ区切り値)に対する本記事の推奨です。CSV出力用の数値・日付変換はOSのカルチャに依存させず、CultureInfo.InvariantCultureを明示することが推奨される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ExcelはCSV(カンマ区切り値)を利用します。Excelは他システムとのデータ交換や一覧の取り込みでCSVファイルを開く / 確度: 確立した関係 / 確認日: 2026-08-01 出典
CSV(カンマ区切り値)はShift_JISを利用します。レガシーシステムとの連携では、CSVの文字コードとして今もShift_JISが使われることがある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

主要概念の定義

CSV(カンマ区切り値): カンマで区切ったテキストでデータを表す、業務アプリのシステム間連携で今も広く使われるファイル形式。
TextFieldParser: 引用符で囲まれたフィールドを正しく処理し、壊れた行をMalformedLineExceptionとして検出できる、.NET標準の区切り形式テキストパーサー。
String.Split(',')による自作CSVパース: カンマで文字列を分割するだけの自作CSV読み込み方式。フィールド内のカンマ・改行・引用符を処理できず仕様上壊れる。
CsvHelper: RFC 4180準拠を掲げ、クラスへのマッピングや遅延読み込みに対応する.NET向けの代表的なCSV読み書きライブラリ。
Excel: ワークシートの読み書きや自動操作の対象になる、Microsoftの表計算ソフトウェア。CSVファイルを開くと値を数値・日付として解釈する。
xlsx出力: セルの書式を出力側で制御できる、xlsx形式でのファイル出力。CSVの値解釈問題を根本的に回避できる。
数式先頭文字の無害化(CSVインジェクション対策): 数式として解釈されうる先頭文字を持つフィールドの先頭にシングルクォートを付けるなどして、CSVインジェクションを無害化する対策。
Shift_JIS: レガシーシステムとの連携で今も使われる日本語の文字コード(コードページ932)。
.NET(Core以降): .NET Frameworkの後継となる、クロスプラットフォーム対応の.NETランタイム(.NET 5以降)。
BOM(Byte Order Mark): ファイル先頭に置かれ、どのUnicodeエンコーディングかを示す数バイトの目印。UTF-8はEF BB BF、UTF-16 LEはFF FE、UTF-16 BEはFE FF。
BOM付きUTF-8: ファイル先頭にBOMを付けたUTF-8。Excelでダブルクリックして開いても文字コードを正しく認識される。
BOMなしUTF-8: BOMを付けないUTF-8。システム間連携ではこちらが使われるが、Excelでのダブルクリックでの自動判別は環境によって成功が保証されない。
CultureInfo.InvariantCulture: OSの地域設定(カルチャ)に依存しない数値・日付の書式変換に使う.NETのカルチャ。CSV出力での区切り文字との衝突回避だけでなく、和暦混入の防止やログ出力の検索性維持など、境界を越える日付・数値の文字列表現を固定したい場面で広く使われる。

機械可読データ

JSON-LD / Turtle ── この記事の知識グラフ全体
概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。