【应用场景】

使用大文本存取和显示大数据。

【案例演示】

采购订单，新增大文本字段，存取和显示大数据。

【实现步骤】

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

using Kingdee.BOS.Core.DynamicForm.PlugIn;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Core.Metadata.FieldElement;
using Kingdee.BOS.Util;
using System;
using System.ComponentModel;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【表单插件】大文本
    /// </summary>
    [Description("【表单插件】大文本"), HotUpdate]
    public class LargeTextFieldFormPlugIn : AbstractDynamicFormPlugIn
    {
        /// <summary>
        /// 字段标识
        /// </summary>
        const string FieldKey = "F_Jac_LargeText";
        public override void BarItemClick(BarItemClickEventArgs e)
        {
            base.BarItemClick(e);
            var largeTextField = (LargeTextField)this.View.BillBusinessInfo.GetField(FieldKey);
            if (e.BarItemKey.EqualsIgnoreCase("test1"))
            {
                // 赋值
                // 大文本的数据有两部分组成：摘要信息(string)、详细信息(byte[])
                // 给摘要信息赋值
                // 方式1：
                this.Model.SetValue(FieldKey, "我是摘要信息：" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
                // 方式2：
                //largeTextField.DynamicProperty.SetValue(this.Model.DataObject, "我是摘要信息：" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
                //this.View.UpdateView(FieldKey);
                // 给详细信息赋值
                var tagString = "我是详细信息：" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");
                var tagValue = tagString.GetUtf8Bytes();
                largeTextField.TagDynamicProperty.SetValue(this.Model.DataObject, tagValue);
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test2"))
            {
                // 取值
                var data = this.Model.GetValue(FieldKey) as string;
                var tagBytes = (byte[])largeTextField.TagDynamicProperty.GetValue(this.Model.DataObject);
                var tagValue = tagBytes == null ? string.Empty : tagBytes.GetUtf8String();
                var msg = string.Format("大文本字段的值：\r\n摘要：{0}\r\n详细：{1}", data, tagValue);
                this.View.ShowMessage(msg);
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test3"))
            {
                // 锁定
                this.View.GetControl(FieldKey).Enabled = false;
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test4"))
            {
                // 解锁
                this.View.GetControl(FieldKey).Enabled = true;
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test5"))
            {
                // 隐藏
                this.View.GetControl(FieldKey).Visible = false;
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test6"))
            {
                // 显示
                this.View.GetControl(FieldKey).Visible = true;
                return;
            }
        }
    }
}

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

<3>BOSIDE扩展采购订单，新增大文本字段，菜单集合新增菜单项，注册表单插件，保存元数据，开发完毕。

【功能验证】

<1>登录业务站点，打开采购订单新增界面，可通过菜单项，完成插件对大文本字段的各种控制。

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

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