下記の質問を記述している際に、エラーメッセージを書く時の書式と分量を判断できずに悩んだ結果、スタックトレースを省略する形で投稿しました。
※このメタ質問で頂いた回答を反映し、現在はスタックトレースを末尾に記述しています。
EPPlusのピボットテーブルでタイトル行が“<”を含むとXmlExceptionが発生する
エラーメッセージを記述する際の書式や分量について、より良い質問をするための指針はあるのでしょうか。
ケースバイケースな部分もあるでしょうけれど、既存のルールや推奨される考え方があれば質問がしやすくなると期待しております。
- 書式は何が良いのか
基本的な質問かも知れませんが、エラーメッセージはコードとブロック引用のどちらで記述するべきでしょうか。
今回の質問では、エラーメッセージはコードでないと判断してブロック引用を用いましたが、スタックトレースを省略せずに記載する場合はコードとして記述し、スクロールバー付きのフォームで表示した方が回答者の読みやすい質問ではないかと悩みました。 - スタックトレースは書くべきか
同じ質問を抱いている第三者に対して、GoogleやYahooなど検索エンジンでのヒット率を上げるという観点では、スタックトレースを書くべきかと思います。
しかし今回の質問では、下記の観点からスタックトレースを省略したくなりました。- 簡潔なコードで再現性がある
- スタックトレースが.Netフレームワークを追う記述が多く、EPPlus固有のコードで解決する手掛かりが乏しいのではないか(質問者の独断)
- スタックトレースの末尾でマイドキュメントのユーザ名が表示されるので、編集が面倒になった
エラーメッセージを一部省略することは推奨されるのか
今回のエラーメッセージ全文は下記の行数になりますが、前半と末尾の数行だけを質問に記述して「簡潔な質問」を目指すことは回答者が歓迎する質問につながりますか。System.Xml.XmlException
HResult=0x80131940
Message='<' (16 進数値 0x3C) は無効な属性文字です。 行 1、位置 458。
Source=System.Xml
スタック トレース:
場所 System.Xml.XmlTextReaderImpl.Throw(Exception e)
場所 System.Xml.XmlTextReaderImpl.Throw(String res, String[] args)
場所 System.Xml.XmlTextReaderImpl.ParseAttributeValueSlow(Int32 curPos, Char quoteChar, NodeData attr)
場所 System.Xml.XmlTextReaderImpl.ParseAttributes()
場所 System.Xml.XmlTextReaderImpl.ParseElement()
場所 System.Xml.XmlTextReaderImpl.ParseElementContent()
場所 System.Xml.XmlTextReaderImpl.Read()
場所 System.Xml.XmlLoader.LoadNode(Boolean skipOverWhitespace)
場所 System.Xml.XmlLoader.LoadDocSequence(XmlDocument parentDoc)
場所 System.Xml.XmlLoader.Load(XmlDocument doc, XmlReader reader, Boolean preserveWhitespace)
場所 System.Xml.XmlDocument.Load(XmlReader reader)
場所 OfficeOpenXml.XmlHelper.LoadXmlSafe(XmlDocument xmlDoc, Stream stream)
場所 OfficeOpenXml.XmlHelper.LoadXmlSafe(XmlDocument xmlDoc, String xml, Encoding encoding)
場所 OfficeOpenXml.Table.PivotTable.ExcelPivotCacheDefinition..ctor(XmlNamespaceManager ns, ExcelPivotTable pivotTable, ExcelRangeBase sourceAddress, Int32 tblId)
場所 OfficeOpenXml.Table.PivotTable.ExcelPivotTable..ctor(ExcelWorksheet sheet, ExcelAddressBase address, ExcelRangeBase sourceAddress, String name, Int32 tblId)
場所 OfficeOpenXml.Table.PivotTable.ExcelPivotTableCollection.Add(ExcelAddressBase Range, ExcelRangeBase Source, String Name)
場所 ConsoleApp1.Program.Main(String[] args) (C:\Users{Who am I}\Documents\Visual Studio 2017\Projects\ConsoleApp1\Program.cs):行 22