/// <summary>Parses .Net XML documentation code tag.</summary>
/// <example><![CDATA[<code>code statements</code>]]></example>
public static new DotNetCommentCode FromVisualStudioXml(XElement element)
{
DotNetComment.ValidateXmlTag(element, "code");
if (element.Attribute("lang") != null)
{
return(new DotNetCommentCodeBlock(element.Value, element.Attribute("lang").Value));
}
return(new DotNetCommentCodeBlock(element.Value));
}
/// <summary>Parses .Net XML documentation "listheader" or "item", expecting one "term" per cell.</summary>
/// <example><![CDATA[<listheader><term>Header 1</term><term>Header 2</term></listheader>]]></example>
/// <example><![CDATA[<item><term>Cell 1</term><term>Cell 2</term></item>]]></example>
public static DotNetCommentRow FromVisualStudioXml(XElement element)
{
DotNetComment.ValidateXmlTag(element, new string[] { "listheader", "item" });
bool isHeader = (element.Name.LocalName == "listheader");
List <DotNetCommentCell> cells = new List <DotNetCommentCell>();
foreach (XElement cell in element.Elements())
{
if (cell.Name.LocalName != "term")
{
continue;
}
cells.Add(new DotNetCommentCell(cell.Value));
}
return(new DotNetCommentRow(cells, isHeader));
}
/// <summary>Parses .Net XML documentation term tag.</summary>
/// <example><![CDATA[<term>plain text</term>]]></example>
public static DotNetCommentCell FromVisualStudioXml(XElement element)
{
DotNetComment.ValidateXmlTag(element, "term");
return(new DotNetCommentCell(element.Value));
}
/// <summary>Parses .Net XML documentation c tag.</summary>
/// <example><![CDATA[<c>code fragment</c>]]></example>
public new static DotNetCommentCode FromVisualStudioXml(XElement element)
{
DotNetComment.ValidateXmlTag(element, "c");
return(new DotNetCommentCode(element.Value.Trim()));
}
