RadEditor.Net2 Summary description for DialogParametersSerializer. Provides storage independent mechanism for uploading files and populating the content of the FileBrowser dialog controls. Creates a new instance of the class. Used internally by RadEditor to create instances of the content provider in its dialog windows. The current HttpContext. Search patterns for files. Allows wildcards. The paths which will be displayed in the dialog. This is passed by RadEditor and is one of the values of ImagesPaths, DocumentsPaths, MediaPaths, FlashPaths, TemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights for directory / file displaying. The paths which will allow uploading in the dialog. This is passed by RadEditor and is one of the values of UploadImagesPaths, UploadDocumentsPaths, UploadMediaPaths, UploadFlashPaths, UploadTemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights for uploading. The paths which will allow deleting in the dialog. This is passed by RadEditor and is one of the values of DeleteImagesPaths, DeleteDocumentsPaths, DeleteMediaPaths, DeleteFlashPaths, DeleteTemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights for deleting. The selected url in the file browser. The file browser will navigate to the item which has this url. The selected tag in the file browser. The file browser will navigate to the item which has this tag. Resolves a root directory with the given path in list mode. The virtual path of the directory. A DirectoryItem array, containing the root directory and all child directories. Resolves a root directory with the given path in tree mode. The virtual path of the directory. A DirectoryItem, containing the root directory. Resolves a directory with the given path. The virtual path of the directory. A DirectoryItem, containing the directory. Used mainly in the Ajax calls. Get the name of the file with the given url. The url of the file. String containing the file name. Gets the virtual path of the item with the given url. The url of the item. String containing the path of the item. Gets a read only Stream for accessing the file item with the given url. The url of the file. Stream for accessing the contents of the file item with the given url. Stores an image with the given url and image format. The Bitmap object to be stored. The url of the bitmap. The image format of the bitmap. string.Empty when the operation was successful; otherwise an error message token. Used when creating thumbnails in the ImageManager dialog. Creates a file item from a HttpPostedFile to the given path with the given name. The uploaded HttpPostedFile to store. The virtual path where the file item should be created. The name of the file item. Additional values to be stored such as Description, DisplayName, etc. String containing the full virtual path (including the file name) of the file item. The default FileUploader control does not include the arguments parameter. If you need additional arguments you should create your own FileUploader control. Deletes the file item with the given virtual path. The virtual path of the file item. string.Empty when the operation was successful; otherwise an error message token. Deletes the directory item with the given virtual path. The virtual path of the directory item. string.Empty when the operation was successful; otherwise an error message token. Creates a directory item in the given path with the given name. The path where the directory item should be created. The name of the new directory item. string.Empty when the operation was successful; otherwise an error message token. Removes the protocol and the server names from the given url. Fully qualified url to a file or directory item. The root based absolute path.

Url: http://www.myserver.com/myapp/mydirectory/myfile Result: /myapp/mydirectory/myfile

Url: www.myserver.com/myapp/mydirectory/myfile Result: /myapp/mydirectory/myfile

The current display mode of the content provider. Can be FileBrowserDisplayMode.Tree or FileBrowserDisplayMode.List. The value of this property is set by the FileBrowser control. Gets a value indicating whether the ContentProvider can create directory items or not. The visibility of the Create New Folder icon is controlled by the value of this property. The HttpContext object, set in the constructor of the class. Gets or sets the url of the selected item. The file browser will navigate to the item which has this url. Gets or sets the tag of the selected item. The file browser will navigate to the item which has this tag. Used mainly in Database content providers, where the file items have special url for accessing. Gets the search patterns for the file items to be displayed in the FileBrowser control. This property is set in the constructor of the class. Supports wildcards. Gets the paths which will be displayed in the dialog. This is passed by RadEditor and is one of the values of ImagesPaths, DocumentsPaths, MediaPaths, FlashPaths, TemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights for directory / file displaying. Gets the paths which will allow uploading in the dialog. This is passed by RadEditor and is one of the values of UploadImagesPaths, UploadDocumentsPaths, UploadMediaPaths, UploadFlashPaths, UploadTemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights for uploading. The paths which will allow deleting in the dialog. This is passed by RadEditor and is one of the values of DeleteImagesPaths, DeleteDocumentsPaths, DeleteMediaPaths, DeleteFlashPaths, DeleteTemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights for deleting. Represents a directory item in the FileBrowser control. The base class of the FileItem and DirectoryItem classes. Contains the common functionality. Serializes the item into a javascript array. This method should be overriden only when developing a custom FileBrowser control. a StringWriter used as a target for the serialization. Utility method used when serializing. Escapes a string for javascript. Utility method used when serializing. Writes a javascript array separator. Utility method used when serializing. Removes the last javascript array separator from the underlying StringBuilder of writer. Serializes the Attributes array. Gets or sets a string array containing custom values which can be used on the client when customizing the FileBrowser control. Clears the Directories array. Can be used when building the directory list in List mode. Serializes the directory item into a javascript array. This method should be overriden only when developing a custom FileBrowser control. a StringWriter used as a target for the serialization. Serializes the children of the directory item as a javascript array. Recursively calls the Serialize methods of all child objects. a StringWriter used as a target for the serialization. Creates an instance of the DirectoryItem class. The name of the directory item. The location of the directory item. To let the FileBrowser control automatically build its path you should set this parameter to string.Empty. If the DirectoryItem is a root item, this parameter must contain the virtual location of the item. The full virtual path of the directory item. Used by the ContentProvider for populating the Directories and Files properties. The tag of the directory item. Used when the virtual path must be different than the url of the item. When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. The permissions for this directory item. A FileItem array containing all child file items. A DirectoryItem array containing all child directory items. Gets the full virtual path to the directory item. Gets the virtual location of the directory item. When the item is not root, the value of this property should be string.Empty. The FileBrowser control recursively combines the names of all parent directory items in order to get the full virtual path of the item. Gets the name of the directory item. The value of this property is displayed in the FileBrowser control. Gets the permissions for this directory item. Gets the tag of the directory item. Used when the virtual path must be different than the url of the item. When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. Gets a DirectoryItem array containing all child directory items. Gets a FileItem array containing all child file items. Utility class for Design - Time VisualStudio.NET project management. Defines the common property categories' names Gets the component's current version. Gets or sets a value indicating whether to use the embedded JavaScript files or not. True if embedded JavaScript files are to be used; otherwise false. The default value is true. Use this property for debugging purposes or to apply any modifications to the JavaScript files. The spellcheck provider enumeration. The default provider. The same as PhoneticProvider This provider uses the edit distance algorithm. It will work for non-western languages. This provider uses phonetic codes to provide "sounds like" word suggestions. Really effective for English, and less so for other languages. This provider automates Microsoft Word via its COM Interop interface. Specifies whether or not to check words in CAPITALS (e.g. 'UNESCO') Specifies whether or not to check words in Capitals (e.g. 'Washington') Specifies whether or not to count repeating words as errors (e.g. 'very very') Specifies whether or not to check words containing numbers (e.g. 'l8r') Create include script tag for every .js file form a given start directory and below SGML is case insensitive, so here you can choose between converting to lower case or upper case tags. "None" means that the case is left alone, except that end tags will be folded to match the start tags. This stack maintains a high water mark for allocated objects so the client can reuse the objects in the stack to reduce memory allocations, this is used to maintain current state of the parser for element stack, and attributes in each element. This class represents an attribute. The AttDef is assigned from a validation process, and is used to provide default values. Attribute objects are reused during parsing to reduce memory allocations, hence the Reset method. This class models an XML node, an array of elements in scope is maintained while parsing for validation purposes, and these Node objects are reused to reduce object allocation, hence the reset method. Attribute objects are reused during parsing to reduce memory allocations, hence the Reset method. SgmlReader is an XmlReader API over any SGML document (including built in support for HTML). The base Uri is used to resolve relative Uri's like the SystemLiteral and Href properties. This is a method because BaseURI is a read-only property on the base XmlReader class. Specify the SgmlDtd object directly. This allows you to cache the Dtd and share it across multipl SgmlReaders. To load a DTD from a URL use the SystemLiteral property. The name of root element specified in the DOCTYPE tag. The PUBLIC identifier in the DOCTYPE tag The SYSTEM literal in the DOCTYPE tag identifying the location of the DTD. The DTD internal subset in the DOCTYPE tag The input stream containing SGML data to parse. You must specify this property or the Href property before calling Read(). Sometimes you need to specify a proxy server in order to load data via HTTP from outside the firewall. For example: "itgproxy:80". Specify the location of the input SGML document as a URL. Whether to strip out the DOCTYPE tag from the output (default true) DTD validation errors are written to this stream. DTD validation errors are written to this log file. Specifies a context menu for an HTML element. Creates a new instance of a context menu for the default element. Creates a new instance of a context menu for an element with the specified tag name The tag name of the element the context menu will be for. Creates a new instance of a context menu for an element with the specified tag name The tag name of the element the context menu will be for. Indicates if the context menu is enabled. Gets or sets a value indicating if the context menu is enabled. A boolean indicating if the context menu is enabled. The default is true. Gets or sets the tag name of the element the context menu is for. A string, representing the tag name of the element the context menu is for. The default value is *, representing the default element (includes all elements not having context menus specified). This example will create a Context menu for images. ContextMenu imageContextMenu = new ContextMenu(); imageContextMenu.ForElement = "IMG"; imageContextMenu.Tools.Add(new ToolbarButton("SetImageProperties")); RadEditor1.ContextMenus.Add(imageContextMenu); Dim imageContextMenu As ContextMenu = New ContextMenu() imageContextMenu.ForElement = "IMG" imageContextMenu.Tools.Add(New ToolbarButton("SetImageProperties")) RadEditor1.ContextMenus.Add(imageContextMenu) Gets or sets the collection of tools the context menu will contain. Provides enumerated values specifying how the editor will pass the parameters to its dialogs. The dialog parameters are serialized and rendered between the editor tags. This increases the control's html size a bit, but makes posible the usage of the control in a web farm and eliminates the problems when the session or the cookie expires. The dialog parameters are stored in the Session. This mode minimizes the size of the control html. It cannot be used when the SessionState is disabled and is prone to problems when the Session expires before the dialog is opened. The dialog parameters are stored in the application Cache; à cookie is used to transport the Cache object key. This mode also minimizes the size of the control html. It cannot be used on web farms and is prone to problems when the cookie expires before the dialog is opened. Provides enumerated values to be used to set image/flash/media/document files permissions. Appoints that the user will be able to browse the specified server path(s). Appoints that the user will be able to delete files from the specified server path(s). Appoints that the user will be able to upload files to the specified server path(s). Appoints that the user will be able to browse/delete/upload files to the specified server path(s). Provides enumerated values to be used to set file(s) types. Specifies an image file type. Specifies a flash file type. Specifies a media file type. Specifies a document file type. Specifies a document file type. Specifies a general file type. Provides enumerated values to be used to set format cleaning options on paste. This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values. Doesn't strip anything on paste, asks a question when MS Word formatting detected. Doesn't strip anything on paste and does not ask a question. Strips only MSWord related attributes and tags on paste. Strips the MSWord related attributes and tags and font tags on paste. Strips MSWord related attributes and tags, font tags and font size attributes on paste. Removes style attributes on paste. Removes Font tags on paste. Clears Span tags on paste. Remove all HTML formatting on paste. telerik r.a.d.editor is the leading WYSIWYG rich-text editor for ASP.NET. It can replace any TextBox with an intuitive Word®-like editor, which enables even non-technical users to author and manage HTML content as easily as writing a document. Used as a base for the RegisterStartupScript method when localization script will be put to the page The relative location of the localization files in relation to the RadControlsDir Sets image/flash/media/document file paths in accordance to the fileTypes and fileOptions parameters. The paths that have to be set. A bitwise OR combination of EditorFileTypes enumeration values. A bitwise OR combination of EditorFileOptions enumeration values. RadEditor can use a dynamically generated ToolsFile.xml instead of the physical one which is located at ~/RadControls/Editor/ToolsFile.xml. You can pass it to the editor as a parameter of the LoadToolsFile(System.Xml.XmlDocument) method. The ToolsFile.xml file, which was dynamically generated in codebehind. Gets or sets the value indicating whether RadEditor will insert the CSS classes defined in the page into the [Format Block] dropdown. true when the page's CSS classes are inserted into the [Format Block] dropdown; otherwise false. The default value is false. This functionality is useful when global styles are applied to H1, H2 and other elements. The RadEditor loading time can increase if the page contains lots of CSS classes. Gets or sets the name of the skin that is used by all editor components - toolbars, dialogs, etc. A string containing the name of the currently used skin. The default value is Default. This property is obsolete. Please, use the Skin property instead. Gets or sets a value indicating whether the RadEditor toolbar should appear on the same page as the edited HTML or float over the page. true if the RadEditor toolbar should appear on the same page as the edited HTML; otherwise false. The default is true. The system modules like the Tag Inspector, Properties Inspector, XHTML Validation Module, etc. cannot float. Note: The value of this property will override the value of UseFixedToolbar. If they are set with oposite values ToolsOnPage will be used. Gets or sets the value indicating whether the RadEditor toolbar will be docked at the top of the page. true when the RadEditor toolbar will be docked at the top of the page; otherwise false. The default value is false. Several editors can simulate usage of the same top toolbar if this property is set to true. Note: The value of this property will be overriden by the ToolsOnPage value. If they are set with oposite values ToolsOnPage will be used. Gets or sets the value indicating whether RadEditor should use session variables or cookies to store its dialog related data. true when session variables are used; false when cookies are used. The default value is false. Both RadEditor and RadSpell can use the ASP.NET session and cookies to store their dialog related data. The default method is a client-side cookie. The cookie storage is limited and many controls on one form might use it completely. The Forms authentication and ASP.NET session might use cookies as well, so cookie storage depletion might affect them as well. Unless the web application's session state is disabled it is recommended to set the value of the UseSession property to true. If the value of the UseSession property is set to false, the expiration period of the cookie can be controlled by using the CookieExpirationTime property. By using this property you switch between the DIV and IFRAME interpretation of r.a.d.editor. Gets or sets the value indicating whether the user who accesses the page can create thumbnails. true when the uses who accesses the page can create thumbnail; otherwise false. The default value is false. RadEditor allows the users to generate thumbnails of existing images on the web-server. The operation can be conducted from the Image Manager dialog. Use this property to limit the users who do not have proper permissions from generating thumbnails. Gets or sets the suffix, which is added to the original file name of the image to form the file name of its thumbnail. The filename suffix for the thumbnail images. The default value is Thumbnail. The suffix is used to separate the thumbnails from the real images. AllowThumbGeneration Property Gets or sets a string containing the path to the XML toolbar configuration file. The default is ~/RadControls/Editor/ToolsFile.xml. Use "~" (tilde) as a substitution of the web-application's root directory. You can also provide this property with an URL which returns a valid XML toolbar configuration file, e.g. ~/Tools/MyToolsFile.aspx RadEditor 5.0 and above. Gets or sets the value indicating whether the user should be allowed to add custom colors to any color picker palette. true when the user can add custom colors to color pickers; otherwise false. The default value is true. Gets or sets the value indicating whether script tags will be allowed in the RadEditor content. true when the script tags are allowed in the RadEditor content; otherwise false. The default value is false. Setting it to false can reduce the possibility of cross-site scripting and other script-related problems. Gets or sets the part of the absolute anchor URLs which will be removed when StripAbsoluteAnchorPaths is set to true. A string containing the part of the absolute anchor URLs which will be removed when StripAbsoluteAnchorPaths is set to true. The default value is string.Empty. This property works along with the StripAbsoluteAnchorPaths property. Note: this functionality is intended for Internet Explorer only. Gecko based browsers like Mozilla do not change the absolute URLs. This example demonstrates the URL changing mechnanisms of Internet Explorer and /// RadEditor. If the RadEditor is placed in a page with URL http://www.telerik.com/management/default.aspx and an anchor with URL "pages/radeditor.aspx" is put on the page using the RadEditor, Internet Explorer will change anchor's URL to http://www.telerik.com/management/pages/radeditor.aspx . If the StripAbsoluteAnchorPaths property is set to true, the RadEditor will change the anchor's URL to: AnchorPathToStrip value Result URL string.Empty (default) /management/pages/radeditor.aspx http://www.tel erik.com/management/pages/radeditor.aspx http://www.telerik.com /management/pages/radeditor.aspx http://www.telerik.com/ management/pages/radeditor.aspx http://www.telerik.com/management /pages/radeditor.aspx http://www.telerik.com/management/ pages/radeditor.aspx http://www.telerik.com/management/pages /radeditor.aspx http://www.telerik.com/management/pages/ radeditor.aspx Gets or sets the value indicating whether the RadEditor's localization data will be created into a separate file or will be embedded into the page. true when the localization is created into a separate file; otherwise false. The default value is false. In order to enable the browsers to cache the localization data set this property to true. This feature may not work if in the application are installed HTTP Modules for URL rewriting or URL authentication. Gets or sets the value indicating whether the [Update] button should perform validation when clicked. true when the [Update] button should perform validation; otherwise false. The default value is true. This property is valid only when the SaveInFile property is set to true. ShowSubmitCancelButtons Property Gets or sets a string containing the path to a valid XML configuration file. The path to a valid XML configuration file. The default value is string.Empty. Gets or sets the value indicating whether the client-side filter that converts the FONT tags to SPAN tags is enabled. true when the FONT tags should be converted to SPAN tags; otherwise false. The default value is false. The filter is activated when the form is submitted or when the editor is switched between normal and HTML mode. See ConvertToXhtml for more information. Gets or sets the value indicating whether the client-side filter that converts the RadEditor content enclosing tags to lower case is enabled. true when the tag names are converted to lower case; otherwise false. The default value is true. The filter is activated when the form is submitted or when the editor is switched between normal and HTML mode. IE makes the names of the RadEditor content enclosing tags upper case, which is not XHTML compliant. See ConvertToXhtml for more information. Gets or sets the value indicating whether the client-side filter that converts the RadEditor content to XHTML is enabled. true when the client-side XHTML filter is enabled; otherwise false. The default value is false. The filter is activated when the form is submitted or when the editor is switched between normal and HTML mode. Note: this filter does not convert the FONT tags to SPAN tags. In order to do this the ConvertFontToSpan property must be set to true. Note: this filter does not convert the RadEditor content enclosing tags to lower case. In order to do this the ConvertTagsToLower property must be set to true. Gets or sets the time-out period (in minutes) allowed between requests before the expiration of the cookie, used for storage of the RadEditor's dialog related data. Time-out period in minutes. The default value is 40. This example demonstrates how to set the RadEditor to use cookies for storing its dialog related data and to set the cookie expiration time-out to 60 minutes. <rade:radeditor
runat="server"
id="RadEditor1"
usesession="false"
cookieexpirationtime="60">
<rade:radeditor> The value of this property is used when the value of the UseSession property is false. Gets or sets the list of external CSS files that should be made available in the editor's content area. By default, RadEditor uses the CSS classes available in the current page. However, it can be configured to load external CSS files instead. This scenario is very common for editors integrated in back-end administration areas, which have one set of CSS classes, while the content is being saved in a database and displayed on the public area, which has a different set of CSS classes. If this property is set the RadEditor loads only the styles defined in these files. The styles defined in the current page are not loaded in the dropdown. If you want to load only a subset of the defined classes you can use the CssClasses property. This example demonstrates how to set the CssFiles property from the code-behind. If you want to set it in the ASPX/ASCX use the following syntax <rade:radeditor cssfiles="~/styles/1.css,~/styles/2.css" ... ><rade:radeditor> RadEditor1.CssFiles = New String(2) {"~/styles/1.css", "~/styles/2.css"} RadEditor1.CssFiles = new string[2] {"~/styles/1.css", "~/styles/2.css"}; RadEditor 5.0 and above. A string array containing the names of the external CSS files that should be available in the editor's content area. Gets or sets the value indicating how the editor will pass the parameters to its dialogs. The default value is DialogParametersMode.Javascript. The dialog parameters are the values of the following properties: ImagesPaths, UploadImagesPaths, DeleteImagesPaths, MaxImageSize, ThumbSuffix, AllowThumbGeneration, DocumentsPaths, UploadDocumentsPaths, DeleteDocumentsPaths, MaxDocumentSize, FlashPaths, UploadFlashPaths, DeleteFlashPaths, MaxFlashSize, MediaPaths, UploadMediaPaths, DeleteMediaPaths, MaxMediaSize, TemplatePaths, UploadTemplatePaths, DeleteTemplatePaths, MaxTemplateSize. DialogParametersMode enum members Member Description Javascript The dialog parameters are serialized and rendered between the editor tags. This increases the control's html size a bit, but makes posible the usage of the control in a web farm and eliminates the problems when the session or the cookie expires. Session The dialog parameters are stored in the Session. This mode minimizes the size of the control html. It cannot be used when the SessionState is disabled and is prone to problems when the Session expires before the dialog is opened. Cookie The dialog parameters are stored in the application Cache; à cookie is used to transport the Cache object key. This mode also minimizes the size of the control html. It cannot be used on web farms and is prone to problems when the cookie expires before the dialog is opened. Gets or sets the fully qualified type name of the FileBrowserContentProvider used in the FileBrowser dialogs, including the assembly name, version, culture, public key token. The default value is string.Empty When the value of this property is string.Empty (default), the FileBrowser dialogs will use the integrated FileSystemContentProvider. Gets or sets the value indicating whether the RadEditor is in edit mode. true when the RadEditor is in edit mode; otherwise false. The default value is true. Use this property if you want to load a page with the content editor set in edit mode. Otherwise, the [pencil] button will be displayed and the content will not be editable until this button is pressed. Note: The [pencil] button will be displayed only when the HasPermission property is set to true. Gets or sets the value indicating whether RadEditor will save the state and positions of its toolbars and modules into a cookie. true when the RadEditor will save the state and position of its toolbars and modules into a cookie; otherwise false. The default value is true. The loading speed of the RadEditor is affected by the state saving ability. It can be increased if this property is set to false. Gets or sets the value indicating whether the RadEditor context menus are enabled. true when the RadEditor context menus are enabled; otherwise false. The default value is true. When the RadEditor context menus are disabled, the browser will display its default context menus. Gets or sets the value indicating whether the RadEditor toolbars and modules are able to dock. true when the RadEditor toolbars and modules are able to dock; otherwise false. The default value is true. The loading speed of the RadEditor is affected by the docking ability. It can be increased if this property is set to false. Gets or sets the value indicating whether the RadEditor will display the HTML tables with dashed borders, will mark the form elements, etc. true when the HTML tables are displayed with dashed borders; otherwise false. The default value is true. This property works by setting special CSS styles to the tables and the form elements in order to change their appearance. There is a probability to get strange behaviour when it is used in conjunction with the CssClass property. Gets or sets the value indicating whether the RadEditor should display the [Indent HTML] checkbox. true when the [Indent HTML] checkbox is displayed; otherwise false. The default value is true. Since version 4.0 the HTML mode has been enhanced to display nicely indented code, which is easier to read and modify. You can turn on or off the indentation by using the [Indent HTML] checkbox. Gets or sets the value indicating whether the RadEditor will render its toolbars on the server. true when the RadEditor will will render its toolbars on the server; otherwise false. The default value is true. This property must be set to false if the toolbars must be rendered on the client, as in version 5.x. Gets or sets the value indicating whether the RadEditor will insert four empty spaces when the user presses the [Tab] key. true when the RadEditor will insert four empty spaces when the user presses the [Tab] key; otherwise false. The default value is true. This property must be set to false if the [Tab] key is needed for navigation between the controls on the page. Gets or sets the code page number used to encode the RadEditor content when saving it into ASCX or ASPX file. The code page number used to encode the RadEditor content when saving it into ASCX or ASPX file. The default value is 65001 (UTF-8). SaveInFile Property The value of this property is used only if the SaveInFile property is set to true. Gets or sets the value indicating whether RadEditor content area should get the focus on itself on load. true when the RadEditor content area should get the focus; otherwise false. The default value is false. Gets or sets the value indicating whether the RadEditor can be switched to edit mode. true when the RadEditor can be switched to edit mode; otherwise false. The default value is true. The edit mode of the RadEditor can be turned on or off by using the Editable property. This property is useful in scenarios where some users are prohibited from editing the content of the page. Gets or sets the height of the RadEditor box. A Unit that represents the height of the control. The default value is 400px. By default moving toolbars and modules around editors docking zones are allowed. Such re-arrangements can alter the editor's size. The page's DOCTYPE can also have effect on the editors size in IE. For example the following two doctypes set Internet Explorer in strict mode. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" >
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> Due to a bug in the rendering implementation of Internet Explorer, the Height of the whole editor (toolbars, content area and modules) is assigned to the editor ContentArea - in effect making the editor "taller" than expected. The developers that want to use DOCTYPES other that the default quirks mode should have this fact in mind and set the editors Height to a smaller value. Gets or sets the text content of the RadEditor control inlcuding the HTML markup. The text content of the RadEditor control including the HTML markup. The default is string.Empty. The text returned by this property contains HTML markup. If only the text is needed use the Text property. It is not guaranteed that the HTML markup from this property will be XHTML compliant. If a valid XHTML is needed, use the Xhtml property. You can also set the text content of the RadEditor inline between its opening and closing tags. In this case setting this property in the code behind will override the inline content. This example demonstrates how to set the content of the RadEditor inline and the differences between the Html, Text and the Xhtml properties. <rade:radeditor id="RadEditor1" runat="server" saveinfile="false" editable="true">
<b>t</b>elerik r.a.d.editor<br>
the best <span style="COLOR: red">html editor</span> in the world
</rade:radeditor>
<asp:button id="btnSave" runat="server" text="Submit" onclick="btnSave_Click" /><br />
Html:<asp:label runat="server" id="LabelHtml"></asp:label><br />
Text:<asp:label runat="server" id="LabelText"></asp:label><br />
Xhtml:<asp:label runat="server" id="LabelXhtml"></asp:label> Private Sub btnSave_Click(sender As Object, e As System.EventArgs) 'HtmlEncode the content of the editor to display the HTML tags LabelHtml.Text = Server.HtmlEncode(RadEditor1.Html); LabelText.Text = Server.HtmlEncode(RadEditor1.Text); LabelXhtml.Text = Server.HtmlEncode(RadEditor1.Xhtml); End Sub private void btnSave_Click(object sender, System.EventArgs e) { //HtmlEncode the content of the editor to display the HTML tags LabelHtml.Text = Server.HtmlEncode(RadEditor1.Html); LabelText.Text = Server.HtmlEncode(RadEditor1.Text); LabelXhtml.Text = Server.HtmlEncode(RadEditor1.Xhtml); } Gets or sets the part of the absolute IMG URLs which will be removed when StripAbsoluteImagesPaths is set to true. A string containing the part of the absolute IMG URLs which will be removed when StripAbsoluteImagesPaths is set to true. The default value is string.Empty. This property works along with the StripAbsoluteImagesPaths property. Note: this functionality is intended for Internet Explorer only. Gecko-based browsers like Mozilla do not change the absolute URLs. This example demonstrates the URL changing mechnanisms of Internet Explorer and RadEditor. If the RadEditor is placed in a page with URL http://www.telerik.com/management/default.aspx and an image with URL "img/radeditor.jpg" is put on the page using the RadEditor, Internet Explorer will change image's URL to http://www.telerik.com/management/img/radeditor.jpg . If the StripAbsoluteImagesPaths property is set to true, the RadEditor will change the image's URL to: ImagesPathToStrip value Result URL string.Empty (default) /management/img/radeditor.jpg http://www.tel erik.com/management/img/radeditor.jpg http://www.telerik.com /management/img/radeditor.jpg http://www.telerik.com/ management/img/radeditor.jpg http://www.telerik.com/management /img/radeditor.jpg http://www.telerik.com/management/ img/radeditor.jpg http://www.telerik.com/management/img /radeditor.jpg http://www.telerik.com/management/img/ radeditor.jpg Gets or sets the localization language for the RadEditor user interface. The localization language for the RadEditor user interface. The default value is en-US. The localization language will be used by the integrated spellchecker as default spellchecking language. If you want to use different language for spellchecking, you should set the DictionaryLanguage property of RadSpell. Gets or sets the value indicating whether the RadEditor will insert a new line or a paragraph when the [Enter] key is pressed. true when the RadEditor will insert <br> tag when the [Enter] key is pressed; otherwise false. The default value is true. When the value of this property is set to true the RadEditor will insert <BR> tags; otherwise it will insert <P></P> tags. Note: this property is intended for use only in Internet Explorer. The gecko-based browsers always insert <BR> tags. Gets the RadSpell object that RadEditor uses for spellchecking. RadSpell theSpellChecker = (RadSpell) editor1.RadSpell; //Check if the editor does not have a spellchecker if (theSpellChecker != null) { ... } RadSpell object which is used for spellchecking by the RadEditor. Gets or sets the fully qualified RadSpell type name, including the assembly name, version, culture, public key token. A string containing the fully qualified RadSpell type name. The default is "Telerik.WebControls.RadSpell, RadSpell". This property is useful when radspell.dll has been deployed in the Global Assembly Cache (GAC). This example demonstrates how to use RadSpell if radspell.dll is deployed in the Global Assembly Cache <rade:radeditor
id="RadEditor1"
runat="server"
radspelltypename="Telerik.WebControls.RadSpell, RadSpell, Version=2.0.2.0, Culture=neutral, PublicKeyToken=b5dad7bf2bf594c2">
</rade:radeditor> Gets or sets the value indicating whether the RadEditor will render as TextArea. true when the RadEditor will will render as TextArea; otherwise false. The default value is false. This property must be set to true if you need to force the editor in low-level browser mode. Gets or sets the value indicating whether the HTML content should be converted to XHTML before it is saved to the ascx/aspx file. true when the HTML content should be converted to XHTML; otherwise false. The default value is false. This property is used in conjunction with the SaveInFile property. If the value of the SaveInFile property is false, the SaveAsXhtml property is ignored. Gets or sets the value indicating whether the HTML content of the RadEditor will be saved into the ASCX/ASPX file. true when the HTML content will be saved into the ASCX/ASPX file; otherwise false. The default value is false. RadEditor have the ability to save its content directly into the ASCX/ASPX file where it is located. This behaviour is useful in simple content management systems. RadEditor can make its content XHTML compliant before saving if the SaveAsXhtml property is set to true. To avoid errors when saving the RadEditor content into a file you should set the AllowScripts property to false. The character encoding of the target files can be controlled by using the FileEncoding property. Note: The ASP.NET process must have write permissions for the file where the RadEditor is located. In more advanced scenarios where the content will be saved into a database or other storage system the content of the RadEditor can be accessed using the Html, Text and Xhtml properties. CausesValidation Property Gets or sets the name of the skin that is used by all editor components - toolbars, dialogs, etc. A string containing the name of the currently used skin. The default value is Default. The RadSpell control will use the value of this property for its own dialogs. If you want to specify different skin for RadSpell you should set its Skin property. RadEditor 6.0 or above. Gets or sets the relative path of the folder containing the skins. If the skin folder is located in the project root and is named "Skins" the SkinsPath property should be set to: "~/Skins". Then you can create subfolders for individual skins e.g. Skins/Gold, Skins/Default etc. A string specifying the relative path to the folder which contains r.a.d.editor skins. The default value is "~/RadControls/Editor/Skins". r.a.d.editor ships with a set of predefined skins which are ready to use. They are located in RadControls/Editor/Skins. Gets or sets the value indicating whether the [Html Mode] icon will be displayed. true when the [Html Mode] icon is displayed; otherwise false. The default value is true. Gets or sets the value indicating whether the [Preview Mode] icon will be displayed. true when the [Preview Mode] icon is displayed; otherwise false. The default value is true. Gets or sets the value indicating whether the [Submit] and [Cancel] buttons will be displayed. true when the [Submit] and [Cancel] buttons are displayed; otherwise false. The default value is true. CausesValidation Property SaveInFile Property Gets or sets the value indicating whether RadEditor should make the absolute images paths relative. true when the absolute image URLs will be changed to relative; otherwise false. The default value is true. Internet Explorer changes all image and anchor URLs to absolute when switching between the modes of RadEditor. RadEditor includes functionality which changes back the absolute URLs to relative. Note: this functionality is intended for Internet Explorer only. Gecko-based browsers like Mozilla do not change the absolute URLs. For more information and an example see ImagesPathToStrip. Gets or sets the value indicating whether RadEditor should make the absolute anchor paths relative. true when the absolute anchor URLs will be changed to relative; otherwise false. The default value is true. Internet Explorer changes all image and anchor URLs to absolute when switching between the modes of RadEditor. RadEditor includes functionality which changes back the absolute URLs to relative. Note: this functionality is intended for Internet Explorer only. Gecko-based browsers like Mozilla do not change the absolute URLs. For more information and an example see AnchorPathToStrip Gets or sets the value indicating how the editor should clear the HTML formatting when the user pastes data into the content area. The default value is EditorStripFormattingOptions.None. EditorStripFormattingOptions enum members Member Description None Doesn't strip anything, asks a question when MS Word formatting was detected. NoneSupressCleanMessage Doesn't strip anything and does not ask a question. MSWord Strips only MSWord related attributes and tags. MSWordNoFonts Strips the MSWord related attributes and tags and font tags. MSWordRemoveAll Strips MSWord related attributes and tags, font tags and font size attributes. Css Removes style attributes. Font Removes Font tags. Span Clears Span tags. All Remove all HTML formatting. Note: In Gecko-based browsers you will see the mandatory dialog box where you need to paste the content. Gets the text content of the RadEditor control without the HTML markup. The text displayed in the RadEditor without the HTML markup. The default is string.Empty. The text returned by this property contains no HTML markup. If only the HTML markup in the text is needed use the Html property. You can set the text content of the RadEditor by using the Html property or inline between its opening and closing tags. In this case setting the Html property in the code behind will override the inline content. For an example see the Html property. Gets or sets the value indicating how the editor toolbar will be rendered and will act on the client Default Toolbars are rendered around the editor content area.
Floating Toolbars are rendered in a moveable window.
PageTop Toolbars appear on top of page when editor gets focus.
ShowOnFocus Toolbars appear right above the editor when it focus. Several editors can simulate usage of the same toolbar if this property has the same value everywhere Gets or sets the height of the RadEditor toolbar. A Unit that represents the height of the toolbar. The default value is 130px. If the ToolsOnPage property is set to false and you have more than two rows of tools on the toolbar, increase the ToolHeight property value to get all of the tools displayed. Gets or sets the width of the RadEditor toolbar. A Unit that represents the width of the toolbar. The default is RadEditor.Width. When the ToolsOnPage property is set to false and the editable area is too narrow for all buttons to fit you can set the value of the ToolsWidth property. Gets or sets the value indicating whether the RadEditor will use RadWindow windows or popup windows for its toolbars and dialogs. true when the RadEditor's toolbars and dialogs use popup windows; otherwise false. The default value is false. The advantage of the RadWindow windows is that they will not be blocked by the browser's pop-up blockers. Moreover, the status bar, which is mandatory for all Internet Explorer browser windows in SP2, will not be displayed, preserving the proper graphic design of the dialogs. Gets or sets the width of the RadEditor box. A Unit that represents the width of the control. The default value is 630px. By default moving toolbars and modules around editors docking zones are allowed. Such re-arrangements can alter the editor's size. Gets the text content of the RadEditor control including the XHTML markup. The text returned by this property contains XHTML compliant HTML markup. If only the text is needed use the Text property. You can set the text content of the RadEditor by using the Html property or inline between its opening and closing tags. In this case setting the Html property in the code behind will override the inline content. The text displayed in the RadEditor including the XHTML markup. The default is string.Empty. For an example see the Html property. Gets or sets the paths where the RadEditor will be able to delete images. A string array which contains the paths where the RadEditor will be able to delete documents. The default value is empty string array. If a folder is present in DeleteDocumentsPaths, but is missing from DocumentsPaths it will not be visible in the Document Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the DocumentsPaths Gets or sets the paths where the RadEditor will be able to delete flash animations. A string array which contains the paths where the RadEditor be able to delete flash animations. The default value is empty string array. If a folder is present in DeleteFlashPaths, but is missing from FlashPaths it will not be visible in the Flash Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the FlashPaths property. Gets or sets the paths where the RadEditor will be able to delete images. A string array which contains the paths where the RadEditor will be able to delete images. The default value is empty string array. If a folder is present in DeleteImagesPaths, but is missing from ImagesPaths it will not be visible in the Image Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the ImagesPaths property. Gets or sets the paths where the RadEditor will be able to delete media files. A string array which contains the paths where the RadEditor be able to delete media files. The default value is empty string array. If a folder is present in DeleteMediaPaths, but is missing from MediaPaths it will not be visible in the Media Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the MediaPaths property. Gets or sets the paths where the RadEditor will be able to delete templates. A string array which contains the paths where the RadEditor will be able to delete templates. The default value is empty string array. If a folder is present in DeleteTemplatePaths, but is missing from TemplatePaths it will not be visible in the Template Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the TemplatePaths property. Gets or sets the file extension filters that control which files are shown in the Document Manager dialog. A string array which contains the file extension filters that control which files are shown in the Document Manager dialog. The default filters are *.*. The following wildcard characters are permitted in a filter string:
* - Zero or more characters.
? - Exactly one character. Note: in the ASPX declaration the filters are comma separated string; in the code behind they are string array. Note: From version 6.0 the default value is changed from *.doc;*.txt to *.* This example demonstrates how to set the Document Manager dialog to display only *.doc and *.xls files using ASPX declaration or code-behind. <rade:radeditor
runat="server"
id="RadEditor1"
documentsfilters="*.doc,*.xls"
/> RadEditor1.DocumentsFilters = New String(2) {"*.doc", "*.xls"} RadEditor1.DocumentsFilters = New String[2] {"*.doc", "*.xls"}; DocumentsPaths Property Gets or sets the paths where the RadEditor will look for documents. If a folder is present in UploadDocumentsPaths or DeleteDocumentsPaths, but is missing from DocumentsPaths it will not be visible in the Document Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. A string array which contains the paths where the RadEditor will look for documents. The default value is empty string array. This example demonstrates how to set the DocumentsPaths , UploadDocumentsPaths and DeleteDocumentsPaths properties in the ASPX or in the code-behind: <rade:radeditor
runat="server"
id="RadEditor1"
documentspaths="~/UploadDocuments,/Documents/Temp,/Documents/Default"
uploaddocumentspaths="~/UploadDocuments,/Documents/Temp"
deletedocumentspaths="/Documents/Temp">
</rade:radeditor> In this specific example the users of the application will see three folders in the Document Manager dialog: UploadDocuments, Default and Temp. When browsing the UploadDocuments and Temp folders, the Upload Document tab will be enabled; otherwise it will be disabled. When browsing the Temp folder, the Delete button in the Browse Files tab will be enabled; otherwise it will be disabled. The Documents folder will not be browsable. If you want to allow the users to browse it you should add "/Documents" to the DocumntsPaths list. RadEditor1.DocumentsPaths = New String(3) {"~/UploadDocuments", "/Documents/Temp", "/Documents/Default"} RadEditor1.UploadDocumentsPaths = New String(2) {"~/UploadDocuments", "/Documents/Temp"} RadEditor1.DeleteDocumentsPaths = New String(1) {"/Documents/Temp"} RadEditor1.DocumentsPaths = new string[3] {"~/UploadDocuments", "/Documents/Temp", "/Documents/Default"}; RadEditor1.UploadDocumentsPaths = new string[2] {"~/UploadDocuments", "/Documents/Temp"}; RadEditor1.DeleteDocumentsPaths = new string[1] {"/Documents/Temp"}; Gets or sets the paths where the RadEditor will look for flash animations. A string array which contains the paths where the RadEditor will look for flash animations. The default value is empty string array. If a folder is present in UploadFlashPaths or DeleteFlashPaths, but is missing from FlashPaths it will not be visible in the Flash Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. This example demonstrates how to set the FlashPaths, UploadFlashPaths and DeleteFlashPaths properties in the ASPX or in the code-behind: <rade:radeditor
runat="server"
id="RadEditor1"
flashpaths="~/UploadFlash,/Flash/Temp,/Flash/Default"
uploadflashpaths="~/UploadFlash,/Flash/Temp"
deleteflashpaths="/Flash/Temp">
</rade:radeditor> In this specific example the users of the application will see three folders in the Flash Manager dialog: UploadFlash, Default and Temp. When browsing the UploadFlash and Temp folders, the Upload Flash tab will be enabled; otherwise it will be disabled. When browsing the Temp folder, the Delete button in the Browse Files tab will be enabled; otherwise it will be disabled. The Flash folder will not be browsable. If you want to allow the users to browse it you should add "/Flash" to the FlashPaths list. RadEditor1.FlashPaths = New String(3) {"~/UploadFlash", "/Flash/Temp", "/Flash/Default"} RadEditor1.UploadFlashPaths = New String(2) {"~/UploadFlash", "/Flash/Temp"} RadEditor1.DeleteFlashPaths = New String(1) {"/Flash/Temp"} RadEditor1.FlashPaths = new string[3] {"~/UploadFlash", "/Flash/Temp", "/Flash/Default"}; RadEditor1.UploadFlashPaths = new string[2] {"~/UploadFlash", "/Flash/Temp"}; RadEditor1.DeleteFlashPaths = new string[1] {"/Flash/Temp"}; Gets or sets the file extension filters that control which files are shown in the Image Manager dialog. A string array which contains the file extension filters that control which files are shown in the Image Manager dialog. The default filters are *.gif, *.jpg, *.png, *.bmp. The following wildcard characters are permitted in a filter string:
* - Zero or more characters.
? - Exactly one character. Note: in the ASPX declaration the filters are comma separated string; in the code behind they are string array. This example demonstrates how to set the Image Manager dialog to display only *.gif and *.jpg files using ASPX declaration or code-behind. <rade:radeditor
runat="server"
id="RadEditor1"
imagesfilters="*.gif,*.jpg"
/> RadEditor1.ImagesFilters = New String(2) {"*.gif", "*.jpg"} RadEditor1.ImagesFilters = New String[2] {"*.gif", "*.jpg"}; ImagesPaths Property Gets or sets the paths where the RadEditor will look for images. A string array which contains the paths where the RadEditor will look for images. The default value is empty string array. If a folder is present in UploadImagesPaths or DeleteImagesPaths, but is missing from ImagesPaths it will not be visible in the Image Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. This example demonstrates how to set the ImagesPaths , UploadImagesPaths and DeleteImagesPaths properties in the ASPX or in the code-behind: <rade:radeditor
runat="server"
id="RadEditor1"
imagespaths="~/UploadImages,/Images/Temp,/Images/Default"
uploadimagespaths="~/UploadImages,/Images/Temp"
deleteimagespaths="/Images/Temp">
</rade:radeditor> In this specific example the users of the application will see three folders in the Image Manager dialog: UploadImages, Default and Temp. When browsing the UploadImages and Temp folders, the Upload Image tab will be enabled; otherwise it will be disabled. When browsing the Temp folder, the Delete button in the Browse Files tab will be enabled; otherwise it will be disabled. The Images folder will not be browsable. If you want to allow the users to browse it you should add "/Images" to the ImagesPaths. RadEditor1.ImagesPaths = New String(3) {"~/UploadImages", "/Images/Temp", "/Images/Default"} RadEditor1.UploadImagesPaths = New String(2) {"~/UploadImages", "/Images/Temp"} RadEditor1.DeleteImagesPaths = New String(1) {"/Images/Temp"} RadEditor1.ImagesPaths = new string[3] {"~/UploadImages", "/Images/Temp", "/Images/Default"}; RadEditor1.UploadImagesPaths = new string[2] {"~/UploadImages", "/Images/Temp"}; RadEditor1.DeleteImagesPaths = new string[1] {"/Images/Temp"}; Gets or sets the maximum file size in bytes allowed for uploading with the Document Manager dialog. The maximum file size in bytes allowed for uploading with the Document Manager dialog. The default value is 512000 bytes. This value must be less than the maxRequestLength setting in the application's web.config or machine.config files. The default maxRequestLength is 4096kB. Gets or sets the maximum file size in bytes allowed for uploading with the Flash Manager dialog. The maximum file size in bytes allowed for uploading with the Flash Manager dialog. The default value is 102400 bytes. This value must be less than the maxRequestLength setting in the application's web.config or machine.config files. The default maxRequestLength is 4096kB. Gets or sets the maximum file size in bytes allowed for uploading with the Image Manager dialog. The maximum file size in bytes allowed for uploading with the Image Manager dialog. The default value is 204800 bytes. This value must be less than the maxRequestLength setting in the application's web.config or machine.config files. The default maxRequestLength is 4096kB. Gets or sets the maximum file size in bytes allowed for uploading with the Media Manager dialog. The maximum file size in bytes allowed for uploading with the Media Manager dialog. The default value is 5242880 bytes. This value must be less than the maxRequestLength setting in the application's web.config or machine.config files. The default maxRequestLength is 4096kB. Gets or sets the maximum file size in bytes allowed for uploading with the Template Manager dialog. The maximum file size in bytes allowed for uploading with the Template Manager dialog. The default value is 204800 bytes. This value must be less than the maxRequestLength setting in the application's web.config or machine.config files. The default maxRequestLength is 4096kB. Gets or sets the file extension filters that control which files are shown in the Media Manager dialog. A string array which contains the file extension filters that control which files are shown in the Media Manager dialog. The default filters are *.asf, *.asx, *.wm, *.wmx, *.wmp, *.wma, *.wax, *.wmv, *.wvx, *.avi, *.wav, *.mpeg, *.mpg, *.mpe, *.m1v, *.mp2, *.mpv2, *.mp2v, *.mpa, *.mp3, *.m3u, *.mid, *.midi, *.rmi, *.aif, *.aifc, *.aiff, *.au, *.snd. The following wildcard characters are permitted in a filter string:
* - Zero or more characters.
? - Exactly one character. Note: in the ASPX declaration the filters are comma separated string; in the code behind they are string array. This example demonstrates how to set the Media Manager dialog to display only *.mp3 and *.wma files using ASPX declaration or code-behind. <rade:radeditor
runat="server"
id="RadEditor1"
mediafilters="*.mp3,*.wma"
/> RadEditor1.MediaFilters = New String(2) {"*.mp3", "*.wma"} RadEditor1.MediaFilters = New String[2] {"*.mp3", "*.wma"}; MediaPaths Property Gets or sets the paths where the RadEditor will look for media files. A string array which contains the paths where the RadEditor will look for media files. The default value is empty string array. If a folder is present in UploadMediaPaths or DeleteMediaPaths, but is missing from MediaPaths it will not be visible in the Media Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. This example demonstrates how to set the MediaPaths, UploadMediaPaths and DeleteMediaPaths properties in the ASPX or in the code-behind: <rade:radeditor
runat="server"
id="RadEditor1"
mediapaths="~/UploadMedia,/Media/Temp,/Media/Default"
uploadmediapaths="~/UploadMedia,/Media/Temp"
deletemediapaths="/Media/Temp">
</rade:radeditor> In this specific example the users of the application will see three folders in the Media Manager dialog: UploadMedia, Default and Temp. When browsing the UploadMedia and Temp folders, the Upload Media tab will be enabled; otherwise it will be disabled. When browsing the Temp folder, the Delete button in the Browse Media tab will be enabled; otherwise it will be disabled. The Media folder will not be browsable. If you want to allow the users to browse it you should add "/Media" to the MediaPaths list. RadEditor1.MediaPaths = New String(3) {"~/UploadMedia", "/Media/Temp", "/Media/Default"} RadEditor1.UploadMediaPaths = New String(2) {"~/UploadMedia", "/Media/Temp"} RadEditor1.DeleteMediaPaths = New String(1) {"/Media/Temp"} RadEditor1.MediaPaths = new string[3] {"~/UploadMedia", "/Media/Temp", "/Media/Default"}; RadEditor1.UploadMediaPaths = new string[2] {"~/UploadMedia", "/Media/Temp"}; RadEditor1.DeleteMediaPaths = new string[1] {"/Media/Temp"}; Gets or sets the file extension filters that control which files are shown in the Template Manager dialog. A string array which contains the file extension filters that control which files are shown in the Template Manager dialog. The default filters are *.html, *.htm. The following wildcard characters are permitted in a filter string:
* - Zero or more characters.
? - Exactly one character. Note: in the ASPX declaration the filters are comma separated string; in the code behind they are string array. This example demonstrates how to set the Template Manager dialog to display only *.xhtml files using ASPX declaration or code-behind. <rade:radeditor
runat="server"
id="RadEditor1"
templatefilters="*.xhtml"
/> RadEditor1.TemplateFilters = New String(1) {"*.xhtml"} RadEditor1.TemplateFilters = New String[1] {"*.xhtml"}; TemplatePaths Property Gets or sets the paths where the RadEditor will look for templates. A string array which contains the paths where the RadEditor will look for templates. The default value is empty string array. If a folder is present in UploadTemplatePaths or DeleteTemplatePaths, but is missing from TemplatePaths it will not be visible in the Template Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. This example demonstrates how to set the TemplatePaths , UploadTemplatePaths and DeleteTemplatePaths properties in the ASPX or in the code-behind: <rade:radeditor
runat="server"
id="RadEditor1"
templatepaths="~/UploadTemplates,/Templates/Temp,/Templates/Default"
uploadtemplatepaths="~/UploadTemplates,/Templates/Temp"
deletetemplatepaths="/Templates/Temp">
</rade:radeditor> In this specific example the users of the application will see three folders in the Image Manager dialog: UploadTemplates, Default and Temp. When browsing the UploadTemplates and Temp folders, the Upload Template tab will be enabled; otherwise it will be disabled. When browsing the Temp folder, the Delete button in the Choose Template tab will be enabled; otherwise it will be disabled. The Templates folder will not be browsable. If you want to allow the users to browse it you should add "/Templates" to the list. RadEditor1.TemplatePaths = New String(3) {"~/UploadTemplates", "/Templates/Temp", "/Templates/Default"} RadEditor1.UploadTemplatePaths = New String(2) {"~/UploadTemplates", "/Templates/Temp"} RadEditor1.DeleteTemplatePaths = New String(1) {"/Templates/Temp"} RadEditor1.TemplatePaths = new string[3] {"~/UploadTemplates", "/Templates/Temp", "/Templates/Default"}; RadEditor1.UploadTemplatePaths = new string[2] {"~/UploadTemplates", "/Templates/Temp"}; RadEditor1.DeleteTemplatePaths = new string[1] {"/Templates/Temp"}; Gets or sets the paths where the RadEditor will be able to upload documents. If a folder is present in UploadDocumentsPaths, but is missing from DocumentsPaths it will not be visible in the Document Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. A string array which contains the paths where the RadEditor will look for documents. The default value is empty string array. For example see the DocumentsPaths property. Gets or sets the paths where the RadEditor will be able to upload flash animations. A string array which contains the paths where the RadEditor be able to upload flash animations. The default value is empty string array. If a folder is present in UploadFlashPaths, but is missing from FlashPaths it will not be visible in the Flash Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the FlashPaths property. Gets or sets the paths where the RadEditor will be able to upload images. A string array which contains the paths where the RadEditor will be able to upload images. The default value is empty string array. If a folder is present in UploadImagesPaths, but is missing from ImagesPaths it will not be visible in the Image Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the ImagesPaths property Gets or sets the paths where the RadEditor will be able to upload media files. A string array which contains the paths where the RadEditor be able to upload media files. The default value is empty string array. If a folder is present in UploadMediaPaths, but is missing from MediaPaths it will not be visible in the Media Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the MediaPaths property. Gets or sets the paths where the RadEditor will be able to upload templates. A string array which contains the paths where the RadEditor will be able to upload templates. The default value is empty string array. If a folder is present in UploadTemplatePaths, but is missing from TemplatePaths it will not be visible in the Template Manager dialog. Use "~/" (tilde) as a substitution of the web-application's root directory. Note: in the ASPX declaration the folders are comma separated string; in the code behind they are string array. For example see the TemplatePaths property Note: This property is new in the .NET Framework version 2.0. Gets or sets the name of the validation group to which this validation control belongs. The name of the validation group to which this validation control belongs. The default is an empty string (""), which indicates that this property is not set. This property works only when CausesValidation is set to true. Gets the collection containing the colors to put in the Foreground and Background color dropdowns. A StringCollection containing the colors to put in the Foreground and Background color dropdowns. Default is an empty StringCollection. The contents of this collection will override the default colors available in the Foreground and Background color dropdowns. In order to extend the default set you should add the default colors and the new colors. Note: Setting this property will affect all color pickers of the RadEditor, including those in the table proprties dialogs. This example demonstrates how to put only Red, Green and Blue into the Foreground and Background dropdowns. Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load RadEditor1.Colors.Add("Red") RadEditor1.Colors.Add("Green") RadEditor1.Colors.Add("Blue") End Sub private void Page_Load(object sender, EventArgs e) { RadEditor1.Colors.Add("Red"); RadEditor1.Colors.Add("Green"); RadEditor1.Colors.Add("Blue"); } ContextMenus collection. Gets the collection containing the CSS classes to put in the [Apply CSS Class] dropdown. A KeyValueCollection containing the CSS classes to put in the [Apply CSS Class] dropdown. Default is an empty KeyValueCollection . The contents of this collection will override the default CSS classes available in the Apply CSS Class dropdown. DialogParameters collection. Gets the collection containing the custom font names to put in the Font dropdown. A string collection containing the custom font names to put in the Font dropdown. Default is an empty StringCollection. The contents of this collection will override the default fonts available in the Font dropdown. In order to extend the default set you should add the default font names and the new font names. The default font names are: Arial, Comic Sans MS, Courier New, Tahoma, Times New Roman, Verdana. Note: the fonts must exist on the client computer. This example demonstrates how to add Arial Narrow font to the Font dropdown. Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load RadEditor1.FontNames.Add("Arial") RadEditor1.FontNames.Add("Arial Narrow") RadEditor1.FontNames.Add("Comic Sans MS") RadEditor1.FontNames.Add("Courier New") RadEditor1.FontNames.Add("Tahoma") RadEditor1.FontNames.Add("Times New Roman") RadEditor1.FontNames.Add("Verdana") End Sub private void Page_Load(object sender, EventArgs e) { RadEditor1.FontNames.Add("Arial"); RadEditor1.FontNames.Add("Arial Narrow"); RadEditor1.FontNames.Add("Comic Sans MS"); RadEditor1.FontNames.Add("Courier New"); RadEditor1.FontNames.Add("Tahoma"); RadEditor1.FontNames.Add("Times New Roman"); RadEditor1.FontNames.Add("Verdana"); } Gets the collection containing the custom font sizes to put in the [Size] dropdown. A string collection containing the custom font sizes to put in the Size dropdown. Default is an empty StringCollection. The contents of this collection will override the default font sizes available in the [Size] dropdown. In order to extend the default set you should add the default font sizes and the new font sizes. The default font sizes are: 1, 2, 3, 4, 5, 6 and 7. Note: the minimum font size is 1, the maximum is 7. This example demonstrates how to remove the font size 1 from the Size dropdown. Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load RadEditor1.FontSizes.Add("2") RadEditor1.FontSizes.Add("3") RadEditor1.FontSizes.Add("4") RadEditor1.FontSizes.Add("5") RadEditor1.FontSizes.Add("6") RadEditor1.FontSizes.Add("7") End Sub private void Page_Load(object sender, EventArgs e) { RadEditor1.FontSizes.Add("2"); RadEditor1.FontSizes.Add("3"); RadEditor1.FontSizes.Add("4"); RadEditor1.FontSizes.Add("5"); RadEditor1.FontSizes.Add("6"); RadEditor1.FontSizes.Add("7"); } Gets the collection containing the custom real font sizes to put in the RealFontSize dropdown. A string collection containing the custom real font sizes to put in the RealFontSize dropdown. Default is an empty StringCollection. The contents of this collection will override the default real font sizes available in the RealFontSize dropdown. This example demonstrates how to add custom font sizes to the RealFontSize dropdown. Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load RadEditor1.RealFontSizes.Add("8pt") RadEditor1.RealFontSizes.Add("9pt") RadEditor1.RealFontSizes.Add("11pt") RadEditor1.RealFontSizes.Add("13pt") End Sub private void Page_Load(object sender, EventArgs e) { RadEditor1.RealFontSizes.Add("8pt") RadEditor1.RealFontSizes.Add("9pt") RadEditor1.RealFontSizes.Add("11pt") RadEditor1.RealFontSizes.Add("13pt") } Gets the collection containing the available languages for spellchecking. RadEditor has integrated support for the multi-language mode of RadSpell. When working with content in different languages you can select the proper spellchecking dictionary from a dropdown button on the RadEditor toolbar. A KeyValueCollection containing the available languages for spellchecking. Default value is empty KeyValueCollection. This example demonstrates how to enable spellchecking for English, French and German languages in RadEditor spellchecker. Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load RadEditor1.Languages.Add("en-US", "English"); RadEditor1.Languages.Add("fr-FR", "French"); RadEditor1.Languages.Add("de-DE", "German"); End Sub private void Page_Load(object sender, EventArgs e) { RadEditor1.Languages.Add("en-US", "English"); RadEditor1.Languages.Add("fr-FR", "French"); RadEditor1.Languages.Add("de-DE", "German"); } Gets the collection containing the links to put in the Custom Links dropdown. A Link object containing the links to put in the Custom Links dropdown. The Custom Links dropdown of the RadEditor is a very convenient tool for inserting predefined hyperlinks. Note: the links can be organized in a tree like structure. This example demonstrates how to create a tree like structure of custom links. Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 'Add the root RadEditor1.Links.Add("telerik", "http://www.telerik.com") 'Add the Products node And its children RadEditor1.Links["telerik"].Add("Products", "http://www.telerik.com/products") RadEditor1.Links["telerik"]["Products"].Add("r.a.d.controls", "http://www.telerik.com/radcontrols") RadEditor1.Links["telerik"]["Products"].Add("r.a.d.editor", "http://www.telerik.com/radeditor") RadEditor1.Links["telerik"]["Products"]["r.a.d.editor"].Add("QSF", "http://www.telerik.com/r.a.d.controls/Editor/Examples/Default/DefaultCS.aspx") 'Add Purchase, Support And Client.Net nodes RadEditor1.Links["telerik"].Add("Purchase", "http://www.telerik.com/purchase") RadEditor1.Links["telerik"].Add("Support", "http://www.telerik.com/support") RadEditor1.Links["telerik"].Add("Client.Net", "http://www.telerik.com/clientnet") End Sub private void Page_Load(object sender, EventArgs e) { //Add the root RadEditor1.Links.Add("telerik", "http://www.telerik.com"); //Add the Products node and its children RadEditor1.Links["telerik"].Add("Products", "http://www.telerik.com/products"); RadEditor1.Links["telerik"]["Products"].Add("r.a.d.controls", "http://www.telerik.com/radcontrols"); RadEditor1.Links["telerik"]["Products"].Add("r.a.d.editor", "http://www.telerik.com/radeditor"); RadEditor1.Links["telerik"]["Products"]["r.a.d.editor"].Add("QSF", "http://www.telerik.com/r.a.d.controls/Editor/Examples/Default/DefaultCS.aspx"); //Add Purchase, Support and Client.Net nodes RadEditor1.Links["telerik"].Add("Purchase", "http://www.telerik.com/purchase"); RadEditor1.Links["telerik"].Add("Support", "http://www.telerik.com/support"); RadEditor1.Links["telerik"].Add("Client.Net", "http://www.telerik.com/clientnet"); } Modules collection. Gets the collection containing the paragraph styles to put in the Paragraph Style dropdown. A KeyValueCollection containing the paragraph styles to put in the Paragraph Style dropdown. Default is an empty KeyValueCollection. The contents of this collection will override the default paragraph styles available in the Paragraph Style dropdown. Note: RadEditor supports also block format with css class set. See the example below. This example demonstrates how to put several paragraph styles in the Paragraph Style dropdown. Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 'Add clear formatting RadEditor1.Paragraphs.Add("Clear Formatting", "body") 'Add the standard paragraph styles RadEditor1.Paragraphs.Add("Heading 1", "<h1>") RadEditor1.Paragraphs.Add("Heading 2", "<h2>") RadEditor1.Paragraphs.Add("Heading 3", "<h3>") 'Add paragraph style With block Format And css Class RadEditor1.Paragraphs.Add("Heading 2 Bordered", "<h2 class=\"bordered\">") End Sub private void Page_Load(object sender, EventArgs e) { //Add clear formatting RadEditor1.Paragraphs.Add("Clear Formatting", "body"); //Add the standard paragraph styles RadEditor1.Paragraphs.Add("Heading 1", "<h1>"); RadEditor1.Paragraphs.Add("Heading 2", "<h2>"); RadEditor1.Paragraphs.Add("Heading 3", "<h3>"); //Add paragraph style with block format and css class RadEditor1.Paragraphs.Add("Heading 2 Bordered", "<h2 class=\"bordered\">"); } Gets the collection containing the snippets to put in the Code Snippet dropdown. A KeyValueCollection containing the snippets to put in the Code Snippet dropdown. Default is an empty KeyValueCollection. The Code Snippet dropdown is a very convenient tool for inserting predefined chunks of HTML content like signatures, product description templates, custom tables, etc. The contents of this collection will override the default snippets available in the Code Snippet dropdown. Gets the collection containing the symbols to put in the Symbols dropdown. A SymbolCollection containing the symbols to put in the Symbols dropdown. Default is an empty SymbolCollection. The contents of this collection will override the default symbols available in the Symbols dropdown. Note: multiple symbols can be added at once by using the SymbolCollection.Add() method. This example demonstrates how to put only the english alphabet symbols to the Symbols dropdown. Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load For i As Integer = 65 To 90 RadEditor1.Symbols.Add(Convert.ToChar(i)) Next End Sub private void Page_Load(object sender, EventArgs e) { for (int i=65; i<=90; i++) { RadEditor1.Symbols.Add(Convert.ToChar(i)); } } Toolbars collection. Gets or sets the value indicating whether the spell will allow adding custom words. The default is true Gets or sets the fully qualified type name that will be used to store and read the custom dictionary. The type name must be fully qualified if the type is in a GAC-deployed assembly. The type must implement the ICustomDictionarySource interface. RadEditor1.SpellCustomDictionarySourceTypeName = "RadSpellExtensions.CustomDictionarySource, RadSpellExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b5e57ccb698eab8e"; RadEditor1.SpellCustomDictionarySourceTypeName = "RadSpellExtensions.CustomDictionarySource, RadSpellExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b5e57ccb698eab8e" Gets or sets the suffix for the custom dictionary files. The default is -Custom The filenames are formed with the following scheme: Language + CustomDictionarySuffix + ".txt". Different suffixes can be used to create different custom dictionaries for different users. Gets or sets the path for the dictionary files. The default is ~/RadControls/Spell/TDF/ This is the path that contains the TDF files, and the custom dictionary TXT files. Gets or sets the spellcheck language if different than the Language property. Gets or sets a the edit distance. If you increase the value, the checking speed decreases but more suggestions are presented. The default is 1 This property takes effect only if the SpellCheckProvider property is set to EditDistanceProvider. Configures the spellchecker engine, so that it knows whether to skip URL's, email addresses, and filenames and not flag them as erros. Specifies the spellchecking algorithm that will be used. The default is TelerikProvider Gets or sets the value used to configure the spellchecker engine to ignore words containing: UPPERCASE, some CaPitaL letters, numbers; or to ignore repeated words (very very) Gets or sets the name of the client-side function which will be executed after the RadEditor is created. A string containing the name of the client-side function which will be executed after the RadEditor is created. The default value is string.Empty. The function should have the following syntax: [JavaScript] function onClientInit(editor)
{
} The parameters are:
editor - the RadEditor instance which is firing the event. Gets or sets the name of the client-side function which will be executed after the RadEditor is loaded. A string containing the name of the client-side function which will be executed after the RadEditor is loaded. The default value is string.Empty. The function should have the following syntax: [JavaScript] function onClientLoad(editor)
{
} The parameters are:
editor - the RadEditor instance which is firing the event. Gets or sets the name of the client-side function which will be executed before a command is processed. A string containing the name of the client-side function which will be executed before a command is processed. The default value is string.Empty. Note: The command processing can be cancelled if the function returns false. The function should have the following syntax: [JavaScript] function onClientCommandExecuting(editor, commandName, tool)
{
} The parameters are:
editor - the RadEditor instance which is firing the event
commandName - the name of the command which is being executed. It is set in the toolbar configuration file
tool - the instance of the custom tool object which is activated by the command commandName Gets or sets the name of the client-side function which will be executed after a command is processed. A string containing the name of the client-side function which will be executed after a command is processed. The default value is string.Empty. The function should have the following syntax: [JavaScript] function onClientCommandExecuted(editor, commandName, tool)
{
} The parameters are:
editor - the RadEditor instance which is firing the event
commandName - the name of the command which is being executed. It is set in the toolbar configuration file
tool - the instance of the custom tool object which is activated by the command commandName Gets or sets the name of the client-side function which will be executed before the RadEditor mode (Design, Html, Preview) is changed. A string containing the name of the client-side function which will be executed before the RadEditor mode (Design, Html, Preview) is changed. The default value is string.Empty. Note: The RadEditor mode change can be cancelled if the function returns false. The function should have the following syntax: [JavaScript] function onClientModeChange(editor)
{
} The parameters are:
editor - the RadEditor instance which is firing the event. Gets or sets the name of the client-side function which will be executed before the RadEditor submit is initiated. A string containing the name of the client-side function which will be executed before the RadEditor submit is initiated. The default value is string.Empty. Note: The RadEditor submission can be cancelled if the function returns false. The function should have the following syntax: [JavaScript] function onClientSubmit(editor)
{
} The parameters are:
editor - the RadEditor instance which is firing the event. Gets or sets the name of the client-side function which will be executed when the RadEditor [Cancel] button is clicked. A string containing the name of the client-side function which will be executed when the RadEditor [Cancel] button is clicked. The default value is string.Empty. Note: The command can be cancelled if the function returns false. The function should have the following syntax: [JavaScript] function onClientCancel(editor)
{
} The parameters are:
editor - the RadEditor instance which is firing the event. Raised only when passing from a non-editable to an editable mode. Raised when the content of the editor has been changed since the previous postback. Raised when an event handler is attached and the [Cancel] button is clicked. Raised when an event handler is attached and the [Update] button is clicked. Needed to set the proper skin to the spell checker; Represents a file item in the FileBrowser control. Serializes the file item into a javascript array. This method should be overriden only when developing a custom FileBrowser control. a StringWriter used as a target for the serialization. Creates an instance of the FileItem class. The name of the file item. The value of this property will be displayed in the FileBrowser control. The file extension of the file item. The size of the file item in bytes. The virtual path of the parent directory item. When the value is string.Empty, the location is the parent's full path. The url which will be inserted into the RadEditor content area. The tag of the file item. Used when the virtual path must be different than the url of the item. When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. The permissions on the file item. Gets the file extension of the file item. Gets the size of the file item in bytes. Gets the virtual path of the parent directory item. When the value is string.Empty, the location is got from the item's parent. Gets the url which will be inserted into the RadEditor content area. Gets the name of the file item. The value of this property will be displayed in the FileBrowser control. Gets the permissions on the file item. Gets the tag of the file item. Used when the virtual path must be different than the url of the item. When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. Summary description for FileUploader. Represents the actions which will be allowed on the FileBrowserItem.

If you want to specify multiple permissions, use the following syntax: 

            Dim permissions As PathPermissions = PathPermissions.Read Or PathPermissions.Upload Or PathPermissions.Delete
The default permission. The FileBrowserItem can only be displayed. Used for DirectoryItems. If enabled, the Upload tab of the dialog will be enabled when the DirectoryItem is opened. If enabled, the DirectoryItem or the FileItem can be deleted. Summary description for ImageMapDialog. Required method for Designer support - do not modify the contents of this method with the code editor. Summary description for XhtmlValidator. Allow the transfer of data files using the W3C's specification for HTTP multipart form data. Microsoft's version has a bug where it does not format the ending boundary correctly. Required method for Designer support - do not modify the contents of this method with the code editor. Allow the transfer of data files using the W3C's specification for HTTP multipart form data. Microsoft's version has a bug where it does not format the ending boundary correctly. Transmits a file to the web server stated in the URL property. You may call this several times and it will use the values previously set for fields and URL. The local path of the file to send. Initialize our class for use to send data files. The URL of the destination server. Used to signal we want the output to go to a text file verses being transfered to a URL. The local path to the output file. Allows you to add some additional field data to be sent along with the transfer. This is usually used for things like userid and password to validate the transfer. The name of the custom field. The value of the custom field. Allows you to add some additional header data to be sent along with the transfer. The name of the custom header. The value of the custom header. Determines if we have a file stream set, and returns either the HttpWebRequest stream or the file. Either the HttpWebRequest stream or the local output file. Make the request to the web server and retrieve it's response into a text buffer. Builds the proper format of the multipart data that contains the form fields and their respective values. All form fields, properly formatted in a string. Returns the proper content information for the file we are sending. The local path to the file that should be sent. All file headers, properly formatted in a string. Creates the proper ending boundary for the multipart upload. The ending boundary. Mainly used to turn the string into a byte buffer and then write it to our IO stream. The stream to write to. The data to place into the stream. Reads in the file a chunck at a time then sends it to the output stream. The stream to write to. The local path of the file to send. Allows you to specify the specific version of HTTP to use for uploads. The dot NET stuff currently does not allow you to remove the continue-100 header from 1.1 and 1.0 currently has a bug in it where it adds the continue-100. MS has sent a patch to remove the continue-100 in HTTP 1.0. Used to change the content type of the file being sent. Currently defaults to: text/xml. Other options are text/plain or binary. The string that defines the begining boundary of our multipart transfer as defined in the w3c specs. This method also sets the Content and Ending boundaries as defined by the w3c specs. The string that defines the content boundary of our multipart transfer as defined in the w3c specs. The string that defines the ending boundary of our multipart transfer as defined in the w3c specs. The data returned to us after the transfer is completed. The web address of the recipient of the transfer. Allows us to determine the size of the buffer used to send a piece of the file at a time out the IO stream. Defaults to 1024 * 10. Allows us to specified the credentials used for the transfer. Allows us to specifiy the certificate to use for secure communications. Gets or sets a value indicating whether to make a persistent connection to the Internet resource. Gets or sets a value indicating whether the Expect100-Continue header should be sent. Gets or sets a value indicating whether to pipeline the request to the Internet resource. Gets or sets a value indicating whether the file can be sent in smaller packets.