Class Tag
- Namespace
- Dynamicweb.Rendering
- Assembly
- Dynamicweb.dll
Represents a template tag definition and its value.
[Serializable]
public class Tag
- Inheritance
-
Tag
- Inherited Members
Examples
using Dynamicweb.Rendering;
namespace Dynamicweb.Examples.Rendering
{
public class TagSample
{
public static void AddTags(Template template)
{
//Create a tag instance and add it to a template instance
var myTag = new Tag("greeting", "Hello");
template.Tags.Add(myTag);
//Create a second tag instance using its Name and Value properties and add it to a template instance
var myTag2 = new Tag();
myTag2.Name = "greeting2";
myTag2.Value = " World!";
template.Tags.Add(myTag2);
//Create a collection of tags and add it to a template instance
var myTags = new TagCollection();
for (int i = 1; i <= 5; i++)
{
myTags.Add(new Tag("Counter" + i.ToString(), i.ToString()));
}
template.Tags.Add(myTags);
//Examine all the tags in the template instance.
foreach (Tag tag in template.Tags)
{
if (tag.Name == "greeting")
{
//Found the tag in the collection named "greeting"
}
}
//Or look it up
if (template.Tags.ContainsTagName("greeting"))
{
//Found the tag in the collection named "greeting"
}
//And clear all tags from the template instances tags collection
template.Tags.Clear();
}
}
}
Remarks
A Tag is represented asd <!--@TagName--> in HTML templates. In XSLT templates the tag is a node in the form <TagName>Value</TagName>
Creating new tags to a template object should use SetTag(string, string, string, string, bool)
Creating new tags to a template object should use SetTag(string, string, string, string, bool)
Constructors
Tag()
Initializes a new instance of the Tag class.
public Tag()
Examples
See usage example in TagTag(string, string)
Initializes a new instance of the Tag class and sets the value of a tag with the specified name.
public Tag(string tagName, string tagValue)
Parameters
Examples
See usage example in TagTag(string, string, string, string)
Initializes a new instance of the Tag class and sets the value of a tag with the specified name and also renderes an attribute on the xml (if template is using a xslt template).
public Tag(string tagName, string tagValue, string xmlAttributeName, string xmlAttributeValue)
Parameters
tagName
string- Name of the tag.
tagValue
string- The tag value.
xmlAttributeName
string- Name of the XML attribute.
xmlAttributeValue
string- The XML attribute value.
Examples
See usage example in TagProperties
Name
Gets or sets the name.
public string Name { get; set; }
Property Value
- string
- The name.
Examples
See usage example in TagValue
Gets or sets the value.
public string Value { get; set; }
Property Value
- string
- The value.
Examples
See usage example in TagXmlAttributeName
Gets or sets the name of the XML attribute. A tag is rendered as <DWPageID>54</DWPageID> in the XML. Using XmlAttributeName and XmlAttributeValue adds an attribute and the specified value to the tagname node.
public string XmlAttributeName { get; set; }
Property Value
- string
- The name of the XML attribute.
XmlAttributeValue
Gets or sets the XML attribute value. A tag is rendered as <DWPageID>54</DWPageID> in the XML. Using XmlAttributeName and XmlAttributeValue adds an attribute and the specified value to the tagname node.
public string XmlAttributeValue { get; set; }
Property Value
- string
- The XML attribute value.