【应用场景】使用列表插件对列表的任意数据行中的任意单元格的数据进行格式化显示。

【案例演示】采购订单，列表查询，当单据状态为创建时，隐藏采购数量。

【实现步骤】

<1>编写列表插件，代码如下。

using Kingdee.BOS.Core.List.PlugIn;

using Kingdee.BOS.Core.List.PlugIn.Args;

using Kingdee.BOS.Util;

using System.ComponentModel;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【列表插件】列表单元格格式化

    /// </summary>

    [Description("【列表插件】列表单元格格式化"), HotUpdate]

    public class FormatCellValueListPlugIn : AbstractListPlugIn

    {

        public override void FormatCellValue(FormatCellValueArgs args)

        {

            base.FormatCellValue(args);

            if (args.Header.Key.EqualsIgnoreCase("FQty"))

            {

                if (args.DataRow.ColumnContains("FDOCUMENTSTATUS") && args.DataRow["FDOCUMENTSTATUS"].ToString() == "A")

                {

                    // 创建状态的单据，不显示采购数量

                    args.FormateValue = "";

                }

            }

        }

    }

}

<2>拷贝插件组件到应用站点的WebSite\Bin目录下，重启IIS。

<3>BOSIDE扩展采购订单，注册列表插件，保存元数据，开发完毕。

【功能验证】

登录业务站点，打开采购订单列表，当单据状态为创建时，采购数量不可见。

---------------------------------------------------------------------------------------------------------

【知识点】

<1>列表表格中的每一个单元格都会执行一次FormatCellValue事件，因此，此事件的执行次数非常多，不宜在此事件中执行高耗费的操作，否则会严重影响列表数据显示的性能。

<2>如果在插件事件中不知道当前正在格式化列表的哪一列，可启动调试后观察args.Header。

<3>如果在插件事件中不知道当前数据行的数据包结构，可启动调试后观察args.DataRow。

---------------------------------------------------------------------------------------------------------

【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696