RuleSetAddTagReplacementRule Method (String, TagAttributeCollection, String, Boolean)
Adds a rule for replacing certain tags with the specified replacement string.

Namespace: MailBee.Html
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.2.0 build 630 for .NET 4.5
public void AddTagReplacementRule(
	string tagName,
	TagAttributeCollection tagAttrs,
	string replacement,
	bool replaceTagDefinitionOnly


Type: SystemString
The name of the tag to be replaced. Case-insensitive.
Type: MailBee.HtmlTagAttributeCollection
The list of attributes any of which must exist in the definition of tagName tags in order to trigger the rule's action, or a null reference (Nothing in Visual Basic) to apply the rule for any tags with tagName name (regardless of which attributes they have).
Type: SystemString
The string which will replace TagDefinition or OuterHtml of the the original element.
Type: SystemBoolean
If true, only the tag definition (opening tag and closing tag if any) will be replaced; otherwise, the entire Element with all inner contents will be replaced.
MailBeeInvalidArgumentExceptiontagName is a null reference (Nothing in Visual Basic) or an empty string, or replacement is a null reference (or an empty string if replaceTagDefinitionOnly is true).

The condition when this rule satisfies is the same as for ProcessingCondition rule (created with AddTagProcessingCondition(String, TagAttributeCollection) method). See AddTagProcessingCondition(String, TagAttributeCollection) topic for the details which apply to the HTML processing rules of all types.

The action for this rule replaces the matching tag either completely (OuterHtml gets replaced) or partially (only TagDefinition gets replaced) depending on replaceTagDefinitionOnly value. If replaceTagDefinitionOnly is true, this rule simply renames the matching tags removing the original name and attributes with supplied ones while leaving InnerHtml intact.

This sample replaces BR tag definitions with HR tag definitions.
// To use the code below, import these namespaces at the top of your code.
using System;
using MailBee.Mime;
using MailBee.Html;

class Sample
    static void Main(string[] args)
        // Load HTML message from file.
        MailMessage message = new MailMessage();

        Processor htmlProcessor = new Processor();

        htmlProcessor.Dom.OuterHtml = message.BodyHtmlText;

        RuleSet rules = new RuleSet();

        rules.AddTagReplacementRule("br", null, "hr", true);

        htmlProcessor.Dom.Process(rules, null);

        // Process the rule and display the results.
        Console.WriteLine(htmlProcessor.Dom.ProcessToString(rules, null));
See Also