/// <summary>Parses .Net XML documentation tag that contains attribute cref.</summary>
/// <example><![CDATA[<exception cref="Namespace.ExceptionType">nested comments and/or plain text</exception>]]></example>
/// <example><![CDATA[<permission cref="Namespace.Type">nested comments and/or plain text</permission>]]></example>
public static new DotNetCommentQualifiedLink FromVisualStudioXml(XElement element)
{
DotNetCommentQualifiedLink link = FromVisualStudioXml(element.GetAttributeValue("cref"));
link.Tag = DotNetComment.GetTag(element);
return(link);
}
/// <summary>Parses .Net XML documentation for permission or exception.</summary>
/// <example><![CDATA[<permission cref="Namespace.Type.Member">nested comments</permission>]]></example>
/// <example><![CDATA[<exception cref="Namespace.ExceptionType">nested comments</exception>]]></example>
public static new DotNetCommentQualifiedLinkedGroup FromVisualStudioXml(XElement element)
{
ValidateXmlTag(element, new string[] { "permission", "exception", "see", "seealso" });
CommentTag tag = DotNetComment.GetTag(element);
DotNetCommentQualifiedLink link = DotNetCommentQualifiedLink.FromVisualStudioXml(element.GetAttributeValue("cref"));
List <DotNetComment> comments = ParseSection(element);
if (link is DotNetCommentMethodLink)
{
return(new DotNetCommentMethodLinkedGroup(link as DotNetCommentMethodLink, tag, comments));
}
return(new DotNetCommentQualifiedLinkedGroup(link, tag, comments));
}
/// <summary>Parses .Net XML documentation for paramref.</summary>
/// <example><![CDATA[<paramref name="paramName" />]]></example>
public static new DotNetCommentParameterLink FromVisualStudioXml(XElement element)
{
ValidateXmlTag(element, "paramref");
return(new DotNetCommentParameterLink(element.GetAttributeValue("name"), DotNetComment.GetTag(element)));
}
/// <summary>Parses .Net XML documentation for any "grouping" tag.</summary>
/// <example><![CDATA[<summary>nested comments and/or plain text</summary>]]></example>
/// <example><![CDATA[<remarks>nested comments and/or plain text</remarks>]]></example>
/// <example><![CDATA[<example>nested comments and/or plain text</example>]]></example>
/// <example><![CDATA[<para>nested comments and/or plain text</para>]]></example>
/// <example><![CDATA[<returns>nested comments and/or plain text</returns>]]></example>
/// <example><![CDATA[<value>nested comments and/or plain text</value>]]></example>
public new static DotNetCommentGroup FromVisualStudioXml(XElement element)
{
return(new DotNetCommentGroup(DotNetComment.GetTag(element), DotNetComment.ParseSection(element)));
}
