首页 > 代码库 > .net类库里ListView的一个BUG

.net类库里ListView的一个BUG

今天在CSDN论坛里看一个帖子,说是在ListView中添加了条目后第一行内容不显示,为了还原他的问题我写了以下代码。

        private void LoadFiles(DirectoryInfo dir)        {            FileInfo[] files = dir.GetFiles();            foreach (FileInfo file in files)            {                ListViewItem item = new ListViewItem();                item.Tag = file;                item.SubItems.AddRange(SubItems.ToArray());                listView1.Items.Add(item);                UpdateItem(item);            }        }        ListViewItem.ListViewSubItem[] SubItems        {            get            {                return new ListViewItem.ListViewSubItem[] { new ListViewItem.ListViewSubItem(), new ListViewItem.ListViewSubItem() };            }        }        private void UpdateItem(ListViewItem item)        {            FileInfo info = (FileInfo)item.Tag;                        item.Text = info.Name;            item.SubItems[1].Text = info.Length.ToString("N0");            item.SubItems[2].Text = info.LastWriteTime.ToString();        }

ListView共有3列,分别显示文件名、大小和最后修改时间,运行以后我发现,文件名可以显示,但是后面2列不能显示。经过各种调试和偶遇,终于让我发现,只要改变ListViewItem.Text的值,后面两列的内容就能够显示了,于是初步解决方案是改变ListViewItem.Text的赋值顺序,把它放在所有SubItem.Text赋值以后再赋值。

为了找到根本原因,我翻查了.net类库的源代码,最后终于发现问题所在,先来看看ListViewSubItem.Text的源代码。

            public string Text {                get {                     return text == null ? "" : text;                 }                set {                     text = value;                    if (owner != null) {                        owner.UpdateSubItems(-1);                    }                 }            } 

在对此属性赋值时,首先检查owner字段的值是否为空,如果不为空才调用owner.UpateSubItems方法对ListView进行更新。很明显,出现上面的问题时,owner值一定为空,通过在VS里调试证实了这点。

现在的问题是,为什么这owner会为空,owner的类型是ListViewItem,从字面理解它应该是SubItem所属的那个行项目,正常情况下在添加到ListViewItem.SubItems以后就应该不会为空,于是我猜是在添加的时候这个owner没有被赋值。后来通过查看源代码以后证实了我的想法,来看看ListViewSubItemCollection关于添加子项的源码。

            public ListViewSubItem Add(ListViewSubItem item) {                 EnsureSubItemSpace(1, -1);                 item.owner = this.owner;                owner.subItems[owner.SubItemCount] = item;                 owner.UpdateSubItems(owner.SubItemCount++);                return item;            }            public void AddRange(ListViewSubItem[] items) {                if (items == null) {                    throw new ArgumentNullException("items");                 }                EnsureSubItemSpace(items.Length, -1);                  foreach(ListViewSubItem item in items) {                    if (item != null) {                         owner.subItems[owner.SubItemCount++] = item;                    }                }                 owner.UpdateSubItems(-1);            } 

很明显,Add方法对owner进行了赋值,但AddRange方法没有,而在帖子里所用的是AddRange方法,所以造成了这个问题。

那为什么对Text赋值以后,子项里的内容又能够显示了呢?好吧,再来看看ListViewItem.Text的源码

        public string Text {            get {                 if (SubItemCount == 0) {                     return string.Empty;                }                 else {                    return subItems[0].Text;                }            }             set {                SubItems[0].Text = value;             }         }

对ListViewItem.Text的赋值实际上就是对它第0个子项的Text赋值,那为什么这个子项可以工作呢,好吧,再来看看第0个子项的来历,以下是ListViewItem.SubItems的源码。

        public ListViewSubItemCollection SubItems {            get {                 if (SubItemCount == 0) {                    subItems = new ListViewSubItem[1];                    subItems[0] = new ListViewSubItem(this, string.Empty);                    SubItemCount = 1;                 }                 if (listViewSubItemCollection == null) {                     listViewSubItemCollection = new ListViewSubItemCollection(this);                }                 return listViewSubItemCollection;            }        }

由于帖子里使用了ListViewItem的无参数构造函数,因此在第一次调用SubItems属性时,SubItemCount的值为0,这时就会自动插入一个子项,而这里使用的构造函数直接把当前ListViewItem传进去了,子项的owner就有了值,因此可以正常显示文字。回想前面的对子项Text赋值的源码,在赋值以后会调用owner.UpdateSubItems(-1)来更新显示,这个方法并不是仅仅更新一个子项,而是会更新所有子项,因此所有的内容又都可以看到了。

最后还有一个问题,为什么调用ListView.Refresh或Invalidate方法没用呢?我没有做深入研究,只是做一个猜想。因为.net的ListView控件只是对原生Windows的ListView控件的封装,在OwnerDraw为false时,所有的绘图都由原生的ListView控件完成。从以上代码可以看出,子项的文本在托管代码里保存了一份,而我敢肯定在原生的控件里也保存了一份,当owner存在时,这两个值是相同的,而在owner不存在时,由于没有更新导致原生控件里没有更新而失去了同步,这样无论怎么Refresh都是没有用的。

Bug就分析到此,原因找到了,解决办也自然有了。但我想说的不是解决办法,而是怎么利用这个BUG,再来看看ListViewItem.UpdateSubItems方法。

        internal void UpdateSubItems(int index){             UpdateSubItems(index, SubItemCount);        }         internal void UpdateSubItems(int index, int oldCount){            if (listView != null && listView.IsHandleCreated) {                int subItemCount = SubItemCount;                 int itemIndex = Index;                  if (index != -1) {                    listView.SetItemText(itemIndex, index, subItems[index].Text);                 }                else {                    for(int i=0; i < subItemCount; i++) {                        listView.SetItemText(itemIndex, i, subItems[i].Text);                     }                }                  for (int i = subItemCount; i < oldCount; i++) {                    listView.SetItemText(itemIndex, i, string.Empty);                 }            }        }

ListViewSubItem.set_Text在调用此方法时,专入的参数是-1,可以看出这将会导致所有的子项重绘,这点前面说过了。按此计算,如果ListView有10列,那每行需要重绘100次,其中有90次是在做无用功,不但增加了CPU的负担,还会可能会导致界面闪烁,但如果合理地利用这个BUG,可以有效改善这个情况。

.net类库里ListView的一个BUG