使用英语阅读

通过


Part.Description 属性

定义

获取或设置一条短语,该短语在部件控件的工具提示和目录中用来概述该部件控件的作用。

public virtual string Description { get; set; }

属性值

一个字符串,简要概述部件控件的功能。 默认值为空字符串 ("")。

示例

下面的代码示例演示了部件控件中 属性的 Description 声明性用法。 此示例需要自定义 WebPart 控件 TextDisplayWebPart,可在类摘要的 Part “示例”部分找到。

在浏览器中加载页面后,如果将鼠标指针放在第一个控件实例的标题文本上,说明文本将显示在工具提示中。

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

注解

属性 Description 通常是一个字符串,用于提供部件控件列表的目录,并在部件控件的标题栏中用作工具提示。 将鼠标指针放在部件控件的 Description 标题栏中的标题文本上时,工具提示中的内容会显示在工具提示中。 工具提示文本是从 属性的值 DisplayTitle 创建的,后跟连字符,后跟 Description 属性值。

设置此属性的值时,可以使用设计器工具自动保存到资源文件。 有关详细信息,请参阅 LocalizableAttribute全球化和本地化

继承者说明

派生类(例如) WebPart 可以替代 Description ,以启用控件说明的用户个性化设置。

适用于

产品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅