| public WriteEndTag ( HtmlTagId id ) : void | ||
| id | HtmlTagId | The HTML tag identifier. |
| return | void | |
public void TestArgumentExceptions ()
{
Assert.Throws<ArgumentNullException> (() => new HtmlWriter (null, Encoding.UTF8));
Assert.Throws<ArgumentNullException> (() => new HtmlWriter (new MemoryStream (), null));
Assert.Throws<ArgumentNullException> (() => new HtmlWriter (null));
using (var html = new HtmlWriter (new StringWriter ())) {
Assert.Throws<ArgumentNullException> (() => html.WriteAttribute (null));
Assert.Throws<ArgumentNullException> (() => html.WriteAttribute (null, string.Empty));
Assert.Throws<ArgumentNullException> (() => html.WriteAttribute ("name", null));
Assert.Throws<ArgumentException> (() => html.WriteAttribute (string.Empty, null));
Assert.Throws<ArgumentException> (() => html.WriteAttribute ("a b c", null));
Assert.Throws<ArgumentNullException> (() => html.WriteAttribute (null, new char[1], 0, 1));
Assert.Throws<ArgumentNullException> (() => html.WriteAttribute ("name", null, 0, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteAttribute ("name", new char[0], -1, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteAttribute ("name", new char[0], 0, 1));
Assert.Throws<ArgumentException> (() => html.WriteAttribute (HtmlAttributeId.Unknown, new char[1], 0, 1));
Assert.Throws<ArgumentNullException> (() => html.WriteAttribute (HtmlAttributeId.Alt, null, 0, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteAttribute (HtmlAttributeId.Alt, new char[0], -1, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteAttribute (HtmlAttributeId.Alt, new char[0], 0, 1));
Assert.Throws<ArgumentException> (() => html.WriteAttributeName (HtmlAttributeId.Unknown));
Assert.Throws<ArgumentNullException> (() => html.WriteAttributeName (null));
Assert.Throws<ArgumentNullException> (() => html.WriteAttributeValue (null));
Assert.Throws<ArgumentNullException> (() => html.WriteAttributeValue (null, 0, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteAttributeValue (new char[0], -1, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteAttributeValue (new char[0], 0, 1));
Assert.Throws<ArgumentException> (() => html.WriteEmptyElementTag (HtmlTagId.Unknown));
Assert.Throws<ArgumentNullException> (() => html.WriteEmptyElementTag (null));
Assert.Throws<ArgumentException> (() => html.WriteEmptyElementTag (string.Empty));
Assert.Throws<ArgumentException> (() => html.WriteEmptyElementTag ("a b c"));
Assert.Throws<ArgumentException> (() => html.WriteEndTag (HtmlTagId.Unknown));
Assert.Throws<ArgumentNullException> (() => html.WriteEndTag (null));
Assert.Throws<ArgumentException> (() => html.WriteEndTag (string.Empty));
Assert.Throws<ArgumentException> (() => html.WriteEndTag ("a b c"));
Assert.Throws<ArgumentNullException> (() => html.WriteMarkupText (null));
Assert.Throws<ArgumentNullException> (() => html.WriteMarkupText (null, 0, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteMarkupText (new char[0], -1, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteMarkupText (new char[0], 0, 1));
Assert.Throws<ArgumentException> (() => html.WriteStartTag (HtmlTagId.Unknown));
Assert.Throws<ArgumentNullException> (() => html.WriteStartTag (null));
Assert.Throws<ArgumentException> (() => html.WriteStartTag (string.Empty));
Assert.Throws<ArgumentException> (() => html.WriteStartTag ("a b c"));
Assert.Throws<ArgumentNullException> (() => html.WriteText (null));
Assert.Throws<ArgumentNullException> (() => html.WriteText (null, 0, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteText (new char[0], -1, 0));
Assert.Throws<ArgumentOutOfRangeException> (() => html.WriteText (new char[0], 0, 1));
Assert.Throws<ArgumentNullException> (() => html.WriteToken (null));
}
}
/// <summary>
/// Convert the contents of <paramref name="reader"/> from the <see cref="InputFormat"/> to the
/// <see cref="OutputFormat"/> and uses the <paramref name="writer"/> to write the resulting text.
/// </summary>
/// <remarks>
/// Converts the contents of <paramref name="reader"/> from the <see cref="InputFormat"/> to the
/// <see cref="OutputFormat"/> and uses the <paramref name="writer"/> to write the resulting text.
/// </remarks>
/// <param name="reader">The text reader.</param>
/// <param name="writer">The text writer.</param>
/// <exception cref="System.ArgumentNullException">
/// <para><paramref name="reader"/> is <c>null</c>.</para>
/// <para>-or-</para>
/// <para><paramref name="writer"/> is <c>null</c>.</para>
/// </exception>
public override void Convert (TextReader reader, TextWriter writer)
{
if (reader == null)
throw new ArgumentNullException (nameof (reader));
if (writer == null)
throw new ArgumentNullException (nameof (writer));
if (!string.IsNullOrEmpty (Header)) {
if (HeaderFormat == HeaderFooterFormat.Text) {
var converter = new TextToHtml ();
using (var sr = new StringReader (Header))
converter.Convert (sr, writer);
} else {
writer.Write (Header);
}
}
using (var htmlWriter = new HtmlWriter (writer)) {
var callback = HtmlTagCallback ?? DefaultHtmlTagCallback;
var stack = new List<HtmlToHtmlTagContext> ();
var tokenizer = new HtmlTokenizer (reader);
HtmlToHtmlTagContext ctx;
HtmlToken token;
while (tokenizer.ReadNextToken (out token)) {
switch (token.Kind) {
default:
if (!SuppressContent (stack))
htmlWriter.WriteToken (token);
break;
case HtmlTokenKind.Tag:
var tag = (HtmlTagToken) token;
if (!tag.IsEndTag) {
//if (NormalizeHtml && AutoClosingTags.Contains (startTag.TagName) &&
// (ctx = Pop (stack, startTag.TagName)) != null &&
// ctx.InvokeCallbackForEndTag && !SuppressContent (stack)) {
// var value = string.Format ("</{0}>", ctx.TagName);
// var name = ctx.TagName;
//
// ctx = new HtmlToHtmlTagContext (new HtmlTokenTag (HtmlTokenKind.EndTag, name, value)) {
// InvokeCallbackForEndTag = ctx.InvokeCallbackForEndTag,
// SuppressInnerContent = ctx.SuppressInnerContent,
// DeleteEndTag = ctx.DeleteEndTag,
// DeleteTag = ctx.DeleteTag
// };
// callback (ctx, htmlWriter);
//}
if (!tag.IsEmptyElement) {
ctx = new HtmlToHtmlTagContext (tag);
if (FilterHtml && ctx.TagId == HtmlTagId.Script) {
ctx.SuppressInnerContent = true;
ctx.DeleteEndTag = true;
ctx.DeleteTag = true;
} else if (!SuppressContent (stack)) {
callback (ctx, htmlWriter);
}
stack.Add (ctx);
} else if (!SuppressContent (stack)) {
ctx = new HtmlToHtmlTagContext (tag);
if (!FilterHtml || ctx.TagId != HtmlTagId.Script)
callback (ctx, htmlWriter);
}
} else {
if ((ctx = Pop (stack, tag.Name)) != null) {
if (!SuppressContent (stack)) {
if (ctx.InvokeCallbackForEndTag) {
ctx = new HtmlToHtmlTagContext (tag) {
InvokeCallbackForEndTag = ctx.InvokeCallbackForEndTag,
SuppressInnerContent = ctx.SuppressInnerContent,
DeleteEndTag = ctx.DeleteEndTag,
DeleteTag = ctx.DeleteTag
};
callback (ctx, htmlWriter);
} else if (!ctx.DeleteEndTag) {
htmlWriter.WriteEndTag (tag.Name);
}
}
} else if (!SuppressContent (stack)) {
ctx = new HtmlToHtmlTagContext (tag);
callback (ctx, htmlWriter);
}
}
break;
}
}
htmlWriter.Flush ();
}
if (!string.IsNullOrEmpty (Footer)) {
if (FooterFormat == HeaderFooterFormat.Text) {
var converter = new TextToHtml ();
using (var sr = new StringReader (Footer))
converter.Convert (sr, writer);
} else {
writer.Write (Footer);
}
}
}
void HtmlTagCallback (HtmlTagContext ctx, HtmlWriter htmlWriter)
{
if (ctx.TagId == HtmlTagId.Body && !ctx.IsEmptyElementTag) {
if (ctx.IsEndTag) {
// end our opening <blockquote>
htmlWriter.WriteEndTag (HtmlTagId.BlockQuote);
// pass the </body> tag through to the output
ctx.WriteTag (htmlWriter, true);
} else {
// pass the <body> tag through to the output
ctx.WriteTag (htmlWriter, true);
// prepend the HTML reply with "On {DATE}, {SENDER} wrote:"
htmlWriter.WriteStartTag (HtmlTagId.P);
htmlWriter.WriteText (GetOnDateSenderWrote (message));
htmlWriter.WriteEndTag (HtmlTagId.P);
// Wrap the original content in a <blockquote>
htmlWriter.WriteStartTag (HtmlTagId.BlockQuote);
htmlWriter.WriteAttribute (HtmlAttributeId.Style, "border-left: 1px #ccc solid; margin: 0 0 0 .8ex; padding-left: 1ex;");
ctx.InvokeCallbackForEndTag = true;
}
} else {
// pass the tag through to the output
ctx.WriteTag (htmlWriter, true);
}
}
/// <summary>
/// Write the HTML tag.
/// </summary>
/// <remarks>
/// Writes the HTML tag to the given <see cref="HtmlWriter"/>.
/// </remarks>
/// <example>
/// <code language="c#" source="Examples\MimeVisitorExamples.cs" region="HtmlPreviewVisitor" />
/// </example>
/// <param name="htmlWriter">The HTML writer.</param>
/// <param name="writeAttributes"><c>true</c> if the <see cref="Attributes"/> should also be written; otherwise, <c>false</c>.</param>
/// <exception cref="System.ArgumentNullException">
/// <paramref name="htmlWriter"/> is <c>null</c>.
/// </exception>
public void WriteTag (HtmlWriter htmlWriter, bool writeAttributes)
{
if (htmlWriter == null)
throw new ArgumentNullException ("htmlWriter");
if (IsEndTag) {
htmlWriter.WriteEndTag (TagName);
return;
}
if (IsEmptyElementTag)
htmlWriter.WriteEmptyElementTag (TagName);
else
htmlWriter.WriteStartTag (TagName);
if (writeAttributes) {
for (int i = 0; i < Attributes.Count; i++)
htmlWriter.WriteAttribute (Attributes[i]);
}
}
public void TestHtmlWriter ()
{
const string expected = "<html ltr=\"true\"><head/><body><p class=\"paragraph\">" +
"special characters in this text should get encoded: <>'&\n" +
"special characters should not get encoded: <>" +
"</p></body></html>";
var actual = new StringBuilder ();
using (var html = new HtmlWriter (new StringWriter (actual))) {
Assert.AreEqual (HtmlWriterState.Default, html.WriterState);
// make sure we can't start by writing an attribute since we are in the wrong state
Assert.Throws<InvalidOperationException> (() => html.WriteAttribute (new HtmlAttribute (HtmlAttributeId.Action, "invalid state")));
Assert.Throws<InvalidOperationException> (() => html.WriteAttribute (HtmlAttributeId.Action, "invalid state"));
Assert.Throws<InvalidOperationException> (() => html.WriteAttribute ("action", "invalid state"));
// write a tag
html.WriteStartTag (HtmlTagId.Html);
Assert.AreEqual (HtmlWriterState.Tag, html.WriterState);
// *now* we should be able to write an attribute
html.WriteAttribute (new HtmlAttribute ("ltr", "true"));
// write en empty element tag, this should change the state to Default
html.WriteEmptyElementTag (HtmlTagId.Head);
Assert.AreEqual (HtmlWriterState.Tag, html.WriterState);
html.WriteStartTag ("body");
Assert.AreEqual (HtmlWriterState.Tag, html.WriterState);
html.WriteStartTag (HtmlTagId.P);
Assert.AreEqual (HtmlWriterState.Tag, html.WriterState);
// make sure that we can't write an attribute value yet
Assert.Throws<InvalidOperationException> (() => html.WriteAttributeValue ("attrValue"));
Assert.Throws<InvalidOperationException> (() => html.WriteAttributeValue ("attrValue".ToCharArray (), 0, 9));
html.WriteAttributeName (HtmlAttributeId.Class);
Assert.AreEqual (HtmlWriterState.Attribute, html.WriterState);
html.WriteAttributeValue ("paragraph");
Assert.AreEqual (HtmlWriterState.Tag, html.WriterState);
html.WriteText ("special characters in this text should get encoded: <>'&\n");
html.WriteMarkupText ("special characters should not get encoded: <>");
Assert.AreEqual (HtmlWriterState.Default, html.WriterState);
html.WriteEndTag (HtmlTagId.P);
html.WriteEndTag (HtmlTagId.Body);
html.WriteEndTag ("html");
}
Assert.AreEqual (expected, actual.ToString ());
}
/// <summary>
/// Convert the contents of <paramref name="reader"/> from the <see cref="InputFormat"/> to the
/// <see cref="OutputFormat"/> and uses the <paramref name="writer"/> to write the resulting text.
/// </summary>
/// <remarks>
/// Converts the contents of <paramref name="reader"/> from the <see cref="InputFormat"/> to the
/// <see cref="OutputFormat"/> and uses the <paramref name="writer"/> to write the resulting text.
/// </remarks>
/// <param name="reader">The text reader.</param>
/// <param name="writer">The text writer.</param>
/// <exception cref="System.ArgumentNullException">
/// <para><paramref name="reader"/> is <c>null</c>.</para>
/// <para>-or-</para>
/// <para><paramref name="writer"/> is <c>null</c>.</para>
/// </exception>
public override void Convert(TextReader reader, TextWriter writer)
{
if (reader == null)
{
throw new ArgumentNullException(nameof(reader));
}
if (writer == null)
{
throw new ArgumentNullException(nameof(writer));
}
if (!string.IsNullOrEmpty(Header))
{
if (HeaderFormat == HeaderFooterFormat.Text)
{
var converter = new TextToHtml();
using (var sr = new StringReader(Header))
converter.Convert(sr, writer);
}
else
{
writer.Write(Header);
}
}
using (var htmlWriter = new HtmlWriter(writer)) {
var callback = HtmlTagCallback ?? DefaultHtmlTagCallback;
var stack = new List <HtmlToHtmlTagContext> ();
var tokenizer = new HtmlTokenizer(reader);
HtmlToHtmlTagContext ctx;
HtmlToken token;
while (tokenizer.ReadNextToken(out token))
{
switch (token.Kind)
{
default:
if (!SuppressContent(stack))
{
htmlWriter.WriteToken(token);
}
break;
case HtmlTokenKind.Comment:
if (!FilterComments)
{
htmlWriter.WriteToken(token);
}
break;
case HtmlTokenKind.Tag:
var tag = (HtmlTagToken)token;
if (!tag.IsEndTag)
{
//if (NormalizeHtml && AutoClosingTags.Contains (startTag.TagName) &&
// (ctx = Pop (stack, startTag.TagName)) != null &&
// ctx.InvokeCallbackForEndTag && !SuppressContent (stack)) {
// var value = string.Format ("</{0}>", ctx.TagName);
// var name = ctx.TagName;
//
// ctx = new HtmlToHtmlTagContext (new HtmlTokenTag (HtmlTokenKind.EndTag, name, value)) {
// InvokeCallbackForEndTag = ctx.InvokeCallbackForEndTag,
// SuppressInnerContent = ctx.SuppressInnerContent,
// DeleteEndTag = ctx.DeleteEndTag,
// DeleteTag = ctx.DeleteTag
// };
// callback (ctx, htmlWriter);
//}
if (!tag.IsEmptyElement)
{
ctx = new HtmlToHtmlTagContext(tag);
if (FilterHtml && ctx.TagId == HtmlTagId.Script)
{
ctx.SuppressInnerContent = true;
ctx.DeleteEndTag = true;
ctx.DeleteTag = true;
}
else if (!SuppressContent(stack))
{
callback(ctx, htmlWriter);
}
stack.Add(ctx);
}
else if (!SuppressContent(stack))
{
ctx = new HtmlToHtmlTagContext(tag);
if (!FilterHtml || ctx.TagId != HtmlTagId.Script)
{
callback(ctx, htmlWriter);
}
}
}
else
{
if ((ctx = Pop(stack, tag.Name)) != null)
{
if (!SuppressContent(stack))
{
if (ctx.InvokeCallbackForEndTag)
{
ctx = new HtmlToHtmlTagContext(tag)
{
InvokeCallbackForEndTag = ctx.InvokeCallbackForEndTag,
SuppressInnerContent = ctx.SuppressInnerContent,
DeleteEndTag = ctx.DeleteEndTag,
DeleteTag = ctx.DeleteTag
};
callback(ctx, htmlWriter);
}
else if (!ctx.DeleteEndTag)
{
htmlWriter.WriteEndTag(tag.Name);
}
}
}
else if (!SuppressContent(stack))
{
ctx = new HtmlToHtmlTagContext(tag);
callback(ctx, htmlWriter);
}
}
break;
}
}
htmlWriter.Flush();
}
if (!string.IsNullOrEmpty(Footer))
{
if (FooterFormat == HeaderFooterFormat.Text)
{
var converter = new TextToHtml();
using (var sr = new StringReader(Footer))
converter.Convert(sr, writer);
}
else
{
writer.Write(Footer);
}
}
}
