HtmlEditorPlaceholderItem.Value Property

Specifies the placeholder value.

Namespace: DevExpress.Web.ASPxHtmlEditor

Assembly: DevExpress.Web.ASPxHtmlEditor.v18.2.dll

Declaration

C#

[DefaultValue("")]
public string Value { get; set; }

VB.NET

<DefaultValue("")>
Public Property Value As String

Property Value

Type	Default	Description
String	String.Empty	An String that specifies the item value.

Example

This example demonstrates how to replace placeholders with data specified as an object. When the Insert Date button is clicked, the DateNow and TimeNow placeholders are replaced using the ASPxHtmlEditor.ReplacePlaceholders method’s ReplacePlaceholders(string html, object placeholders) overload.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/aspxhtmleditor-how-to-specify-placeholders-using-dictionary-and-object-structures-t283576

Placeholder.aspx (C#)

<dx:ASPxHtmlEditor ID="HtmlEditor" ClientInstanceName="HtmlEditor" runat="server">
    <Toolbars>
        <dx:HtmlEditorToolbar>
            <Items>
                <dx:ToolbarUndoButton>
                </dx:ToolbarUndoButton>
                <dx:ToolbarRedoButton>
                </dx:ToolbarRedoButton>
                <dx:ToolbarBoldButton BeginGroup="True">
                </dx:ToolbarBoldButton>
                <dx:ToolbarItalicButton>
                </dx:ToolbarItalicButton>
                <dx:ToolbarUnderlineButton>
                </dx:ToolbarUnderlineButton>
                <dx:ToolbarStrikethroughButton>
                </dx:ToolbarStrikethroughButton>
                <dx:ToolbarJustifyLeftButton BeginGroup="True">
                </dx:ToolbarJustifyLeftButton>
                <dx:ToolbarJustifyCenterButton>
                </dx:ToolbarJustifyCenterButton>
                <dx:ToolbarJustifyRightButton>
                </dx:ToolbarJustifyRightButton>
                <dx:ToolbarInsertPlaceholderDialogButton>
                </dx:ToolbarInsertPlaceholderDialogButton>
            </Items>
        </dx:HtmlEditorToolbar>
    </Toolbars>
    <Placeholders>
        <dx:HtmlEditorPlaceholderItem Value="DateNow" />
        <dx:HtmlEditorPlaceholderItem Value="TimeNow" />
        <dx:HtmlEditorPlaceholderItem Value="FirstName" />
        <dx:HtmlEditorPlaceholderItem Value="LastName" />
    </Placeholders>
</dx:ASPxHtmlEditor>
<dx:ASPxButton ID="SignatureButton" runat="server" OnClick="Insert_Signature" 
    Text="Insert Signature"></dx:ASPxButton>
<dx:ASPxButton ID="DateButton" runat="server" OnClick="Insert_Date" Text="Insert Date">
</dx:ASPxButton>

Placeholder.aspx.cs

private class PlaceholdersForDate {
    private DateTime date = DateTime.Now;
    private string formatDate = "d MMM yyyy";
    private string formatTime = "HH:mm";
    public string DateNow {
        get {
            return date.ToString(formatDate);
        }
    }
    public string TimeNow {
        get {
            return date.ToString(formatTime);
        }
    }
}
// Replaces placeholders specified as an object
protected void Insert_Date(object sender, EventArgs e) {
    PlaceholdersForDate placeholdersForDate = new PlaceholdersForDate();
    string html = HtmlEditor.Html;
    string newHtml = ASPxHtmlEditor.ReplacePlaceholders(html, placeholdersForDate);
    HtmlEditor.Html = newHtml;
}

Placeholder.aspx (VB.NET)

<dx:ASPxHtmlEditor ID="HtmlEditor" ClientInstanceName="HtmlEditor" runat="server">
    <Toolbars>
        <dx:HtmlEditorToolbar>
            <Items>
                <dx:ToolbarUndoButton>
                </dx:ToolbarUndoButton>
                <dx:ToolbarRedoButton>
                </dx:ToolbarRedoButton>
                <dx:ToolbarBoldButton BeginGroup="True">
                </dx:ToolbarBoldButton>
                <dx:ToolbarItalicButton>
                </dx:ToolbarItalicButton>
                <dx:ToolbarUnderlineButton>
                </dx:ToolbarUnderlineButton>
                <dx:ToolbarStrikethroughButton>
                </dx:ToolbarStrikethroughButton>
                <dx:ToolbarJustifyLeftButton BeginGroup="True">
                </dx:ToolbarJustifyLeftButton>
                <dx:ToolbarJustifyCenterButton>
                </dx:ToolbarJustifyCenterButton>
                <dx:ToolbarJustifyRightButton>
                </dx:ToolbarJustifyRightButton>
                <dx:ToolbarInsertPlaceholderDialogButton>
                </dx:ToolbarInsertPlaceholderDialogButton>
            </Items>
        </dx:HtmlEditorToolbar>
    </Toolbars>
    <Placeholders>
        <dx:HtmlEditorPlaceholderItem Value="DateNow" />
        <dx:HtmlEditorPlaceholderItem Value="TimeNow" />
        <dx:HtmlEditorPlaceholderItem Value="FirstName" />
        <dx:HtmlEditorPlaceholderItem Value="LastName" />
    </Placeholders>
</dx:ASPxHtmlEditor>
<dx:ASPxButton ID="SignatureButton" runat="server" OnClick="Insert_Signature" 
    Text="Insert Signature"></dx:ASPxButton>
<dx:ASPxButton ID="DateButton" runat="server" OnClick="Insert_Date" Text="Insert Date">
</dx:ASPxButton>

Placeholder.aspx.vb

Private Class PlaceholdersForDate
    Private [date] As Date = Date.Now
    Private formatDate As String = "d MMM yyyy"
    Private formatTime As String = "HH:mm"
    Public ReadOnly Property DateNow() As String
        Get
            Return [date].ToString(formatDate)
        End Get
    End Property
    Public ReadOnly Property TimeNow() As String
        Get
            Return [date].ToString(formatTime)
        End Get
    End Property
End Class
' Replaces placeholders specified as an object
Protected Sub Insert_Date(ByVal sender As Object, ByVal e As EventArgs)
    Dim placeholdersForDate As New PlaceholdersForDate()
    Dim html As String = HtmlEditor.Html
    Dim newHtml As String = ASPxHtmlEditor.ReplacePlaceholders(html, placeholdersForDate)
    HtmlEditor.Html = newHtml
End Sub