dotnet / dotnet/dotnet-api-docs

Should mention differentiation between property schema changes and item data changes

未关闭
#1,908 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
area-System.ComponentModel dotnet-api/prod Pri2 untriaged
主要语言
C#
星标
949
派生
1.7k
平均合并
3 天 27 分钟
30 天内合并 PR
49

描述

The constructor with a propertychanged mentions that it should only be used for object schema changes and with adequate `ListChangedType` value.

This is in contrast to item changes, which specify item indices and different `ListChangedType` values.

The remarks section on this type, `ListChangedEventArgs`, should mention and describe this differentiation.

Furthermore, it is unclear how a combination of the two should be handled. The `ListChangedType` can not be combined, but constructors with both types of parameters imply this is somehow possible and intended, but they do not document how it's supposed to work/be handled.

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 97c8c9f6-72f6-2fb9-feed-d9a0bfb6348f
* Version Independent ID: 72c6439d-375b-e584-fd70-593411554e41
* Content: [ListChangedEventArgs Class (System.ComponentModel)](https://docs.microsoft.com/en-us/dotnet/api/system.componentmodel.listchangedeventargs?view=netframework-4.7.2)
* Content Source: [xml/System.ComponentModel/ListChangedEventArgs.xml](https://github.com/dotnet/dotnet-api-docs/blob/master/xml/System.ComponentModel/ListChangedEventArgs.xml)
* Product: **dotnet-api**
* GitHub Login: @dotnet-bot
* Microsoft Alias: **dotnetcontent**

贡献指南

打开贡献指南

调研方向

Start with xml/System.ComponentModel/ListChangedEventArgs.xml and its constructors and remarks, then review the referenced ListChangedType documentation to establish the distinction between property-schema and item-data changes. Done means the remarks clearly explain both cases and how constructor arguments should be handled together.

由索引模型根据 Issue 内容生成。

评估

技术栈
csharp
领域
documentation
Issue 类型
文档
难度
2/5
预计耗时
1-3 小时
活跃度
停滞
描述清晰度
基本清楚
新手友好度
42/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。