ASPxHtmlEditorSettings.AllowInsertDirectImageUrls Property

Gets or sets a value that specifies whether direct links to the specified images located on other web sites are allowed to be inserted into the editor’s HTML markup.

Namespace: DevExpress.Web.ASPxHtmlEditor

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

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(true)]
public bool AllowInsertDirectImageUrls { get; set; }

VB.NET

<DefaultValue(True)>
Public Property AllowInsertDirectImageUrls As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true if direct links to external images are allowed; false to download external images to the web site’s upload folder and refer to them using local paths.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to AllowInsertDirectImageUrls
ASP.NET Controls and MVC Extensions	ASPxHtmlEditor	.Settings .AllowInsertDirectImageUrls
ASP.NET MVC Extensions	HtmlEditorSettings	.Settings .AllowInsertDirectImageUrls
	MVCxHtmlEditor	.Settings .AllowInsertDirectImageUrls

Remarks

Use the AllowInsertDirectImageUrls property to specify whether the ASPxHtmlEditor allows inserting direct links to external images located on other web sites.

Note that if direct image links are allowed, they may be a potential cause of harmful actions (for instance, a specific harmful script can try to run if it’s assigned as an external image’s Load event handler).

To avoid using direct links, set the AllowInsertDirectImageUrls property to false. In this case, any specified external image is first downloaded to a specific folder on the application’s web server, and then it’s referred to within the editor using its local path. Use the ASPxHtmlEditorImageUploadSettings.UploadImageFolder property, to specify the folder that contains uploaded images used by the ASPxHtmlEditor control.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AllowInsertDirectImageUrls property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-set-up-a-custom-font-dialog-e1934/CS/HtmlEditorCustomFontDialog/DevExpress/ASPxHtmlEditorForms/InsertImageForm.ascx.cs#L33

protected void Page_Load(object sender, EventArgs e) {
    ckbSaveToServer.ClientVisible = HtmlEditor.Settings.AllowInsertDirectImageUrls && !string.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder);
    rblFromThisComputer.ClientEnabled = !string.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder);

how-to-use-the-client-performdatacallback-method-and-the-server-customdatacallback-event-e1397/CS/HtmlEditorSaveHtml/DevExpress/ASPxHtmlEditorForms/InsertImageForm.ascx.cs#L33

protected void Page_Load(object sender, EventArgs e) {
    ckbSaveToServer.ClientVisible = HtmlEditor.Settings.AllowInsertDirectImageUrls && !string.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder);
    rblFromThisComputer.ClientEnabled = !string.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder);

how-to-provide-an-end-user-with-a-list-of-templates-to-insert-into-the-editor-e1974/CS/InsertTemplateText/DevExpress/ASPxHtmlEditorForms/InsertImageForm.ascx.cs#L33

protected void Page_Load(object sender, EventArgs e) {
    ckbSaveToServer.ClientVisible = HtmlEditor.Settings.AllowInsertDirectImageUrls && !string.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder);
    rblFromThisComputer.ClientEnabled = !string.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder);

VB.NET

how-to-set-up-a-custom-font-dialog-e1934/VB/HtmlEditorCustomFontDialog/DevExpress/ASPxHtmlEditorForms/InsertImageForm.ascx.vb#L36

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    ckbSaveToServer.ClientVisible = HtmlEditor.Settings.AllowInsertDirectImageUrls AndAlso Not String.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder)
    rblFromThisComputer.ClientEnabled = Not String.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder)

how-to-use-the-client-performdatacallback-method-and-the-server-customdatacallback-event-e1397/VB/HtmlEditorSaveHtml/DevExpress/ASPxHtmlEditorForms/InsertImageForm.ascx.vb#L36

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    ckbSaveToServer.ClientVisible = HtmlEditor.Settings.AllowInsertDirectImageUrls AndAlso Not String.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder)
    rblFromThisComputer.ClientEnabled = Not String.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder)

how-to-provide-an-end-user-with-a-list-of-templates-to-insert-into-the-editor-e1974/VB/InsertTemplateText/DevExpress/ASPxHtmlEditorForms/InsertImageForm.ascx.vb#L36

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    ckbSaveToServer.ClientVisible = HtmlEditor.Settings.AllowInsertDirectImageUrls AndAlso Not String.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder)
    rblFromThisComputer.ClientEnabled = Not String.IsNullOrEmpty(HtmlEditor.SettingsImageUpload.UploadImageFolder)