New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial

Represents a control which is capable of displaying images from a binary data

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

C#
[TelerikToolboxCategory("Miscellaneous")]
[ToolboxBitmap(typeof(RadBinaryImage), "Toolbox.Icons.BinaryImage.png")]
public class RadBinaryImage : WebControl, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor

Inheritance: objectControlWebControlRadBinaryImage

Implements: IAttributeAccessorIComponentIControlBuilderAccessorIControlDesignerAccessorIDataBindingsAccessorIDisposableIExpressionsAccessorIParserAccessorIUrlResolutionService...

Inherited Members WebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.CreateControlStyle()WebControl.LoadViewState(object)WebControl.TrackViewState()WebControl.MergeStyle(Style)WebControl.RenderBeginTag(HtmlTextWriter)WebControl.RenderEndTag(HtmlTextWriter)WebControl.RenderContents(HtmlTextWriter)WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnabledWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SupportsDisabledAttributeWebControl.SkinIDWebControl.TabIndexWebControl.TagNameWebControl.ToolTipWebControl.WidthControl.ResolveAdapter()Control.HasEvents()Control.GetRouteUrl(object)Control.GetRouteUrl(string, object)Control.GetRouteUrl(RouteValueDictionary)Control.GetRouteUrl(string, RouteValueDictionary)Control.GetUniqueIDRelativeTo(Control)Control.ApplyStyleSheetSkin(Page)Control.OnDataBinding(EventArgs)Control.DataBind(bool)Control.DataBindChildren()Control.AddParsedSubObject(object)Control.EnsureID()Control.OnInit(EventArgs)Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.Focus()Control.LoadControlState(object)Control.MapPathSecure(string)Control.OpenFile(string)Control.OnLoad(EventArgs)Control.BuildProfileTree(string, bool)Control.SaveControlState()Control.RenderChildren(HtmlTextWriter)Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.OnBubbleEvent(object, EventArgs)Control.AddedControl(Control, int)Control.CreateControlCollection()Control.CreateChildControls()Control.ResolveUrl(string)Control.ResolveClientUrl(string)Control.FindControl(string)Control.FindControl(string, int)Control.GetDesignModeState()Control.HasControls()Control.IsLiteralContent()Control.EnsureChildControls()Control.RemovedControl(Control)Control.SetDesignModeState(IDictionary)Control.SetRenderMethodDelegate(RenderMethod)Control.ClientIDModeControl.ClientIDControl.ClientIDSeparatorControl.ContextControl.AdapterControl.DesignModeControl.EventsControl.IDControl.IsChildControlStateClearedControl.EnableViewStateControl.ViewStateModeControl.IsViewStateEnabledControl.NamingContainerControl.IdSeparatorControl.LoadViewStateByIDControl.PageControl.RenderingCompatibilityControl.TemplateControlControl.ParentControl.TemplateSourceDirectoryControl.AppRelativeTemplateSourceDirectoryControl.SiteControl.VisibleControl.UniqueIDControl.HasChildViewStateControl.ControlsControl.ValidateRequestModeControl.ViewStateControl.ViewStateIgnoresCaseControl.ChildControlsCreatedControl.IsTrackingViewStateControl.DisposedControl.DataBindingControl.InitControl.LoadControl.PreRenderControl.Unloadobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Properties

Gets or sets the alternate text displayed in the Image control when the image is unavailable. Browsers that support the ToolTips feature display this text as a ToolTip.

C#
[Bindable(true)]
public virtual string AlternateText { get; set; }

Specifies if the HTML image element's dimensions are inferred from image's binary data

C#
public bool AutoAdjustImageControlSize { get; set; }

Specifies the crop position RadListView will use when cropping the image. This property has a meaning only when the ResizeMode property is set to BinaryImageResizeMode.Crop. Default value is BinaryImageCropPosition.Center.

C#
public virtual BinaryImageCropPosition CropPosition { get; set; }

Gets or sets binary data to which control will be bound to

C#
[SuppressMessage("Microsoft.Performance", "CA1819:PropertiesShouldNotReturnArrays")]
[Bindable(true)]
public byte[] DataValue { get; set; }

The URL for the file that contains a detailed description for the image. The default is an empty string ("").

C#
public virtual string DescriptionUrl { get; set; }

When set to true enables support for WAI-ARIA

C#
public bool EnableAriaSupport { get; set; }

Gets or sets a value indicating whether the control generates an alternate text attribute for an empty string value. The default value is false

C#
public virtual bool GenerateEmptyAlternateText { get; set; }

Specifies the URL of the HTTPHandler from which the image will be served

C#
public string HttpHandlerUrl { get; set; }
Exceptions: ArgumentException

Gets or sets the alignment of the RadBinaryImage control in relation to other elements on the Web page.

C#
public virtual ImageAlign ImageAlign { get; set; }
Exceptions: ArgumentOutOfRangeException

Gets the IRadImagePersister instance which is responsible for saving and loading image's data

C#
protected virtual IRadImagePersister ImagePersister { get; }

This should be an instance of same type as RadBinaryImageHandler 's ImagePersister

C#
public BinaryImageStorageLocation ImageStorageLocation { get; set; }

Gets or sets the location of an image to display in the RadBinaryImage control.

C#
[Bindable(true)]
public virtual string ImageUrl { get; set; }

Applicable only when DataValue property is not set.

Gets or sets a value indicating whether the image data will be persisted if control is invisible

C#
public virtual bool PersistDataIfNotVisible { get; set; }

Specifies the resize mode that RadBinaryImage will use to resize the image. Default value is BinaryImageResizeMode.None, indicating no resizing will be performed.

C#
public virtual BinaryImageResizeMode ResizeMode { get; set; }

Get or set the name of the file which will appear inside of the SaveAs browser dialog

C#
public virtual string SavedImageName { get; set; }

Gets the HtmlTextWriterTag value that corresponds to this Web server control. This property is used primarily by control developers.

C#
protected override HtmlTextWriterTag TagKey { get; }
Property Value:

One of the HtmlTextWriterTag enumeration values.

Overrides: WebControl.TagKey

Set whenever to render <img> tag when the image src is empty string. Default value is true.

C#
public bool VisibleWithoutSource { get; set; }

Methods

Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. This method is used primarily by control developers.

C#
protected override void AddAttributesToRender(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

A HtmlTextWriter that represents the output stream to render HTML content on the client.

Overrides: WebControl.AddAttributesToRender(HtmlTextWriter)

C#
protected virtual BinaryImageFilterProcessor CreateFilterProcessor()
Returns:

BinaryImageFilterProcessor

C#
protected virtual BinaryImageTransformationFilter CreateImageTransformationFilter()
Returns:

BinaryImageTransformationFilter

Binds a data source to the invoked server control and all its child controls.

C#
public override void DataBind()

Overrides: Control.DataBind()

C#
protected bool IsDefaultHandlerUrl()
Returns:

bool

C#
protected override void OnPreRender(EventArgs e)
Parameters:eEventArgs

Overrides: Control.OnPreRender(EventArgs)

C#
protected override void Render(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: WebControl.Render(HtmlTextWriter)

Saves any state that was modified after the TrackViewState() method was invoked.

C#
protected override object SaveViewState()
Returns:

object

An object that contains the current view state of the control; otherwise, if there is no view state associated with the control, null.

Overrides: WebControl.SaveViewState()

C#
protected virtual void SetImageFileNameToPersister(IRadImagePersister persister)
Parameters:persisterIRadImagePersister