关于成员访问枚举

简短描述

描述使用成员访问运算符时自动枚举列表集合项。

详细描述

从 PowerShell 3.0 开始，成员访问枚举功能提高了在列表集合对象上使用成员访问运算符 (.) 的便利性。当您使用成员访问运算符访问集合中不存在的成员时，PowerShell 会自动枚举集合中的项目并尝试访问每个项目上的指定成员。

成员访问枚举可帮助您编写更简单、更短的代码。您可以使用成员访问运算符，而不是通过管道将集合对象传递给 ForEach-Object 或使用 ForEach() 内部方法来访问集合中每个项目的成员在集合对象上。

这些命令在功能上与演示成员访问运算符的使用的最后一个命令相同：

Get-Service -Name event* | ForEach-Object -Process { $_.DisplayName }
(Get-Service -Name event*).ForEach({ $_.DisplayName })
(Get-Service -Name event*).DisplayName

Windows Event Log
COM+ Event System

Windows Event Log
COM+ Event System

Windows Event Log
COM+ Event System

笔记

您可以使用成员访问运算符来获取集合中项目的属性值，但不能使用它直接设置它们。有关更多信息，请参阅 about_Arrays。

当您在任何对象上使用成员访问运算符并且指定的成员存在于该对象上时，就会调用该成员。对于属性成员，运算符返回该属性的值。对于方法成员，操作符调用对象上的该方法。

当您对不具有指定成员的列表集合对象使用成员访问运算符时，PowerShell 会自动枚举该集合中的项目，并对每个枚举项目使用成员访问运算符。

您可以通过查看对象的类型是否实现了IList接口来检查对象是否是列表集合：

$List = @('a', 'b')
$Hash = @{ a = 'b' }
$List.GetType().ImplementedInterfaces.Name -contains 'IList'
$Hash.GetType().ImplementedInterfaces.Name -contains 'IList'

True

False

在属性的成员访问枚举期间，运算符返回具有该属性的每个项目的属性值。如果没有项具有指定的属性，则运算符返回$null。

在方法的成员访问枚举期间，运算符尝试对集合中的每个项目调用该方法。如果集合中的任何项没有指定的方法，则该运算符将返回 MethodNotFound 异常。

警告

在方法的成员访问枚举期间，会在集合中的每个项目上调用该方法。如果您调用的方法发生更改，则会对集合中的每个项目进行更改。如果枚举期间发生错误，则仅对错误之前枚举的项调用该方法。为了提高安全性，请考虑手动枚举项目并显式处理任何错误。

以下示例详细说明了成员访问运算符在所有可能情况下的行为。

访问非列表对象的成员

当您对不是列表集合但具有成员的对象使用成员访问运算符时，该命令将返回该对象的属性值或方法的输出。

$MyString = 'abc'
$MyString.Length
$MyString.ToUpper()

3

ABC

当您对没有成员的非列表对象使用成员访问运算符时，如果您指定了属性，则该命令将返回 $null；如果指定了属性，则该命令将返回 MethodNotFound 错误你指定一个方法。

$MyString = 'abc'
$null -eq $MyString.DoesNotExist
$MyString.DoesNotExist()

True

InvalidOperation:
Line |
   3 |  $MyString.DoesNotExist()
     |  ~~~~~~~~~~~~~~~~~~~~~~~~
     | Method invocation failed because [System.String] does not contain a method named 'DoesNotExist'.

访问列表集合对象的成员

当您对具有成员的集合对象使用成员访问运算符时，它始终返回集合对象的属性值或方法结果。

访问集合中存在的成员，但不访问其项目

在此示例中，指定的成员存在于集合中，但不存在其中的项目。

[System.Collections.Generic.List[string]]$Collection = @('a', 'b')
$Collection.IsReadOnly
$Collection.Add('c')
$Collection

False

a
b
c

访问集合及其项目中存在的成员

对于此示例，指定的成员同时存在于集合及其中的项目中。将对集合使用成员访问运算符的命令结果与对 ForEach-Object 中的集合项使用成员访问运算符的结果进行比较。在集合上，运算符返回集合对象的属性值或方法结果，而不是其中的项。

[System.Collections.Generic.List[string]]$Collection = @('a', 'b', 'c')
$Collection.Count
$Collection | ForEach-Object -Process { $_.Count }
$Collection.ToString()
$Collection | ForEach-Object -Process { $_.ToString() }

3

1
1
1

System.Collections.Generic.List`1[System.String]

a
b
c

笔记

实现System.Collections.IDictionary接口的集合（例如HashTable和OrderedDictionary）具有不同的行为。当您在具有与属性同名的键的字典上使用成员访问运算符时，它会返回键的值而不是属性的值。

您可以使用 psbase 内部成员访问字典对象的属性值。例如，如果键名称为 keys 并且您想要返回 HashTable 键的集合，请使用以下语法：

$hashtable.PSBase.Keys

访问集合中所有项目中存在的成员（但不存在其本身）

当您对不具有成员但其中包含项目的集合对象使用成员访问运算符时，PowerShell 会枚举集合中的项目并返回每个项目的属性值或方法结果。

[System.Collections.Generic.List[string]]$Collection = @('a', 'b', 'c')
$Collection.Length
$Collection.ToUpper()

1
1
1

A
B
C

访问集合及其项目中都不存在的成员

当您在没有成员且其中的项目也没有的集合对象上使用成员访问运算符时，如果您指定属性或 MethodNotFound 如果指定方法会出错。

[System.Collections.Generic.List[string]]$Collection = @('a', 'b', 'c')
$null -eq $Collection.DoesNotExist
$Collection.DoesNotExist()

True

InvalidOperation:
Line |
   3 |  $Collection.DoesNotExist()
     |  ~~~~~~~~~~~~~~~~~~~~~~~~~~
     | Method invocation failed because [System.String] does not contain a method named 'DoesNotExist'.

由于集合对象没有成员，PowerShell 枚举了集合中的项目。请注意，MethodNotFound 错误指定 System.String 不包含该方法，而是 System.Collections.Generic.List。

访问仅存在于集合中某些项目的方法

当您使用成员访问运算符访问集合对象上没有该方法且只有集合中的某些项目具有该方法的方法时，该命令将返回 MethodNotFound 错误集合中没有该方法的项。即使在某些项目上调用该方法，该命令也只会返回错误。

@('a', 1, 'c').ToUpper()

InvalidOperation: Method invocation failed because [System.Int32] does not contain a method named 'ToUpper'.

访问仅存在于集合中某些项目的属性

当您使用成员访问运算符访问不具有该属性的集合对象上的属性并且集合中只有部分项目具有该属性时，该命令将返回集合中具有该属性的每个项目的属性值。

$CapitalizedProperty = @{
    MemberType = 'ScriptProperty'
    Name       = 'Capitalized'
    Value      = { $this.ToUpper() }
    PassThru   = $true
}
[System.Collections.Generic.List[object]]$MixedCollection = @(
    'a'
    ('b' | Add-Member @CapitalizedProperty)
    ('c' | Add-Member @CapitalizedProperty)
    'd'
)
$MixedCollection.Capitalized

B
C

参见

• about_Arrays
• about_Intrinsic_Members
• about_方法
• about_Operators
• about_属性