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.5.0 build 687 for .NET 4.5
Syntax
Copy
public void AddTagReplacementRule(
	string tagName,
	TagAttributeCollection tagAttrs,
	string replacement,
	bool replaceTagDefinitionOnly
)

Parameters

tagName
Type: SystemString
The name of the tag to be replaced. Case-insensitive.
tagAttrs
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).
replacement
Type: SystemString
The string which will replace TagDefinition or OuterHtml of the the original element.
replaceTagDefinitionOnly
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.
Exceptions
ExceptionCondition
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).
Remarks

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.

Examples
This sample replaces BR tag definitions with HR tag definitions.
Copy
// 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();
        message.LoadMessage(@"C:\Temp\message.eml");

        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