System.DirectoryServices.DirectorySearcher.PropertyNamesOnly的文档不正确 [英] Incorrect documentation for System.DirectoryServices.DirectorySearcher.PropertyNamesOnly

问题描述

请参阅此页： http://msdn.microsoft.com/en -us / library / system.directoryservices.directorysearcher.propertynamesonly.aspx

文档说，"获取或设置一个值，指示搜索是否仅检索值所属的属性的名称已被分配。"

这是非常误导，如果不是完全错误。
我（以及其他人 - 我可以在互联网上的一些示例程序中看到它）将此解释为当此属性为真时：
- 如果属性具有值，则名称为检索到 - 如果财产没有值，则不检索姓名

这是错误！

这个财产实际上是什么（如其名称所隐含的）是，如果它是真的，则仅返回属性名称，如果为假，则返回属性名称和值（如果有值）。

谢谢。

See this page: http://msdn.microsoft.com/en-us/library/system.directoryservices.directorysearcher.propertynamesonly.aspx

The documentation says, "Gets or sets a value indicating whether the search retrieves only the names of attributes to which values have been assigned."

This is very misleading, if not outright wrong.

I (and others - I can see it in some sample programs in the Internet) interpreted this to mean that when this property is true:
- if a property has a value the name is retrieved
- if a property does not have a value the name is not retrieved

This is wrong!

What this property actually does (and as is implied by its name), is that if it is true only property names are returned, and if it is false both property names and values (if there is a value) are returned.

Thank you.

推荐答案

感谢您指出这个潜在的文档错误Rennie。我将研究这一点，以便在适当时验证和更正该文件。

Thanks for pointing out this potential documentation error Rennie. I will research this to verify and correct the document as appropriate.

此致，

Bruce Perler

Bruce Perler

Windows Server Developer Docs

Windows Server Developer Docs

这篇关于System.DirectoryServices.DirectorySearcher.PropertyNamesOnly的文档不正确的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！