RadBinaryImage

RadBinaryImage提供一种简单的方法来显示作为二进制数据存储在数据库中的图像。该控件可用于任何数据绑定控件(中继器，DataList，显示数据表格等)来显示来自数据源中的二值图像字段的图像。该控件使用一个内部http处理程序，该处理程序将图像从二进制源流传输到必须在其中可视化图像的页面。在控件本身和处理程序之间传输二进制流时的存储是HttpContext.Current.Cache对象，图像将缓存在浏览器中。其默认过期时间为2小时(除非控件中的RadBinaryImage嵌套、反弹或重新创建)。这意味着当使用相同的url进行访问时，二进制图像的后续加载将从浏览器缓存中获取。在禁用浏览器缓存的情况下，图像将在服务器上持久保存2分钟，然后才从数据源流到页面。

RadBinaryImage是Telerik UI for ASP。净AJAX，一个具有 120+ 组件的专业级UI库，用于构建现代和功能丰富的 应用程序。想要试用它，请注册一个30天的免费试用。

下载免费试用

最重要的性质RadBinaryImage下一段的表格中列出了控制项:

RadBinaryImage设计时间

RadBinaryImage智能标签提供了对控件最常用属性的方便访问。您可以通过右键单击设计窗口中的RadBinaryImage，并从它的上下文菜单中选择“显示智能标签”选项来显示智能标签。

当你想使用RadBinaryImage显示透明的。gif图像时，你应该设置它的ResizeMode财产没有一个．这是因为不支持使用这些文件的图像转换。

这是一个在线演示其中演示了如何集成RadBinaryImage作为ASP。网中继器模板。结果的屏幕截图如下:

  
    
 
    
 
公司名称:<%#Eval("CompanyName")%>
 
 
   < div class = "数据容器”> < ul > <李> <标记>联系人姓名:< /标签> < % # Eval(“联系名称”)% > < /李> <李> < >标签标题:< /标签> < % # Eval (ContactTitle) % > < /李> <李> <标记>城市:< /标签> < % # Eval(“城市”)% > < /李> <李> <标记>:< /标签> < % # Eval(“国家”)% > < /李> <李> <标记>电话:< /标签> < % # Eval("电话")% > < /李> < / ul > < / div > < / div > < /自定义字段> < / ItemTemplate > < / asp:中继器> < div风格= "明确:;"> 
    
  
      
      
map
  .

的http处理程序RadBinaryImage控件的聪明的标签或在. config文件，以确保在呈现页面时按预期提供该文件。即:

 …< =“Telerik.Web.UI.WebResource添加路径。axd Telerik.Web.UI“type =”。网络Resource" verb="*" validate="false" /> 

<系统。网络服务器>…   

调整

RadBinaryImage支持以下通过ResizeMode属性设置的调整大小模式。

• 没有一个—禁用“调整大小”(这是默认值)。
• 作物-超出宽度/高度的部分将被修剪以匹配输出比，其余部分将被缩放(调整尺寸)以匹配目标尺寸。
• 适合-图像将调整大小以适应目标尺寸。
• 填满-图像将被调整大小以填充目标尺寸。注意，这可能会扭曲图像。

wai - aria支持

的RadBinaryImage控制提供wai - aria支持，可以通过设置EnableAriaSupport服务器属性设置为真正的．

RadBinaryImage ARIA属性小写．它们如下表所示:

在HTML文档中使用WAI-ARIA的一个问题是它们不进行验证。当您通过W3C Validator运行包含ARIA属性的HTML文档时，它会在任何ARIA属性的结果中显示错误。DOCTYPE声明不包含任何关于WAI ARIA属性的信息，并且您不能拥有一个包含元素、属性和属性值的有效文档，这些属性值在其DTD中没有详细说明。

在WebFarm/WebGarden环境中使用RadBinaryImage

默认情况下RadBinaryImage控件将BinaryImage存储在Cache对象中。如果你的应用程序被配置为在下面列出的任何环境中运行，那么访问二进制映像将会出现问题:

• 网络农场-应用程序同时运行在多个web服务器上。

• Web花园-应用程序运行在单个服务器上，但是服务器负载被分配到多个工作进程中(多个进程运行同一个应用程序)。

通常，每个服务器(或每个工作进程)都有一个独立的Cache，这意味着，当页面请求不是由同一个web服务器(工作进程)处理时，BinaryImage将为空，并显示一个灰色图像。

为了避免这种行为，您应该将二进制映像存储在会话中，并配置您的服务器环境以使用进程外会话状态(即。Session对象在不同的进程和服务器之间共享)。最后一个目标可以通过以下步骤实现:

1. 设置RadBinaryImage。图像StorageLocation财产会话．

2. 设置一个sessionState如在这博客文章。

3. 配置httpHandler的方法如下:

<配置> <系统。web>          

另请参阅

• 为ASP集成RadControls。净AJAXin a WebFarm or WebGarden scenario