ASPxMemo Class

A multi-line text editor.

Assembly : DevExpress.Web.v25.2.dll

Declaration

C#
VB.NET

csharp

public class ASPxMemo :
    ASPxTextEdit

Public Class ASPxMemo
    Inherits ASPxTextEdit

Remarks

The Memo allows you to input text in multiple lines.

Create a Memo

Design Time

The ASPxMemo control is available on the DX.25.2: Common Controls toolbox tab in the Microsoft Visual Studio IDE.

Drag the control onto a form and customize the control’s settings, or paste the control markup in the page’s source code.

Note

To properly function, DevExpress controls require that special modules, handlers and options are registered in the the Web.config file. Switch the Microsoft Visual Studio IDE to the Design tab to automatically update the Web.config file with the required DevExpress information.

ASPX

aspx

<dx:ASPxMemo ID="ASPxMemo2" runat="server" Height="70px" Width="170px" Text="Sample Text" HorizontalAlign="Justify" Caption="Caption Text">
</dx:ASPxMemo>

csharp

using DevExpress.Web;
...
protected void Page_Load(object sender, EventArgs e)
{
    ASPxMemo memo = new ASPxMemo();
    memo.ID = "ASPxMemo1";
    memo.Height = Unit.Pixel(70);
    memo.Width = Unit.Pixel(170);
    memo.Text = "Sample Text";
    memo.Caption = "Caption Text";
    memo.HorizontalAlign = HorizontalAlign.Justify;
    memo.Theme = "Office365";
    Page.Form.Controls.Add(memo);
}

Imports DevExpress.Web
...
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim memo As ASPxMemo = New ASPxMemo()
    memo.ID = "ASPxMemo1"
    memo.Height = Unit.Pixel(70)
    memo.Width = Unit.Pixel(170)
    memo.Text = "Sample Text"
    memo.Caption = "Caption Text"
    memo.HorizontalAlign = HorizontalAlign.Justify
    memo.Theme = "Office365"
    Page.Form.Controls.Add(memo)
End Sub

Client-Side API

The ASPxMemo ‘s client-side API is implemented with JavaScript language and exposed by the ASPxClientMemo object.

Availability

Available by default.

| |

Client object type

ASPxClientMemo

| |

Access name

ASPxMemo.ClientInstanceName

| |

Events

ASPxMemo.ClientSideEvents

ASPX

aspx

<dx:ASPxMemo ID="ASPxMemo2" runat="server" Height="70px" ClientInstanceName="memo" Width="170px">
</dx:ASPxMemo>

<dx:ASPxButton ID="Button" runat="server" Text="Get memo text" AutoPostBack="false">
    <ClientSideEvents Click="OnClick" />
</dx:ASPxButton>

function OnClick(s, e) {
    alert(memo.GetText());
}

Automatic Scroll Bar Activation

The Memo shows the vertical scroll bar automatically if the content does not fit the editor’s size.

Null Prompt Text

The Memo allows you to display a prompt text (NullText, NullTextDisplayMode ) if the editor’s content is empty and the editor is not focused. The prompt text disappears when the editor receives focus.

ASPX

aspx

<dx:ASPxMemo ID="ASPxMemo2" NullText="Null Text" NullTextDisplayMode="UnfocusedAndFocused" ...>
</dx:ASPxMemo>

See demo

Native Mode

Set the Native property to true to render the ASPxMemo as a native HTMl element (textarea). This reduces the amount of generated HTML code and improves the editor’s performance. In native mode, the memo’s appearance depends on how the client browser renders native HTML elements.

Learn more | See demo

Built-in Validation

The Memo allows you to validate its data on the client and server side and provide descriptive error messages when necessary.

ASPX

aspx

<dx:ASPxMemo ID="ASPxMemo2" ...>
    <ValidationSettings Display="Dynamic" ErrorDisplayMode="Text" ValidateOnLeave="true">
        <RequiredField ErrorText="Custom Error Text" IsRequired="true" />
    </ValidationSettings>
</dx:ASPxMemo>

Learn more | See demo