main

Author: sharpchen

docs/document/Skill/PowerShell/docs/Language/PSCustomObject.md

@@ -17,15 +17,15 @@ The must-know is **`[PSCustomObject]` maps to the same type as `[psobject]`, `Sy
 The only valid usage is marking one HashTable as `System.Management.Automation.PSCustomObject`. Other possible usages of `[PSCustomObject]` is bascially pointless.
 
 > [!WARNING]
-> Do not use `PSCustomObject` case-sensitive keys matters, name of extended properties are not case-sensitive, use `HashTable` instead.
+> Do not use `PSCustomObject` if case-sensitive keys matter, name of extended properties are not case-sensitive, use `HashTable` instead.
 
 ## Creation
 
 PSCustomObject borrows the syntax from HashTable with a casting.
 
 ```ps1
 $john = [PSCustomObject] @{
-    Name = 'John Smith' 
+    Name = 'John Smith'
     Age = 18
 }
 ```
@@ -39,7 +39,7 @@ $table = @{
     Foo = 'foo'
 }
 
-$obj = [PSCustomObject]$table # [!code highlight] 
+$obj = [PSCustomObject]$table # [!code highlight]
 ```
 
 Or use `New-Object`, but this might be slower.
@@ -52,9 +52,28 @@ $obj = New-Object -TypeName PSObject -Property $table
 
 ```ps1
 $john = [PSCustomObject] @{
-    Name = 'John Smith' 
+    Name = 'John Smith'
     Age = 18
 }
 
 $smith = $john.psobject.Copy()
 ```
+
+## Add New Members
+
+You can't directly add new properties after declaration using dot accessor.
+One should use `Add-Member` to append new members.
+
+```ps1
+$obj | Add-Member -MemberType NoteProperty -Name PropName -Value Value
+```
+
+> [!NOTE]
+> All members of a `[pscustomobject]` should be *extended properties*, you can inspect them using `$obj.psextended`
+
+## Enumerating Properties
+
+```ps1
+$obj.psobject.properties | foreach { $_.Value = 0 }
+```
+

docs/document/Skill/PowerShell/docs/Object Manipulation/5.Select.md

@@ -10,7 +10,7 @@ The following is a overview:
 - Take a count from start or end with `-First` or `-Last`.
 - Skip a count from start or end `-Skip` or `-SkipLast`.
 - Cherry-Pick one or more items by zero-based index.
-- Distinct items selected from pipline.
+- Distinct items selected from pipeline.
 
 > [!TIP]
 > Use `select` alias for `Select-Object`.
@@ -104,7 +104,7 @@ gps | select -ExpandProperty Name
 `-ExpandProperty` can be used together with `-Property`, selected properties by `-Property` will be added as **NoteProperty** to the selected `-ExpandProperty`.
 
 > [!WARNING]
-> This approach mutates the selected property instead of generating a new object.
+> This approach mutates the selected property for `-ExpandProperty` instead of generating a new object.
 
 ```ps1
 $player = @{
@@ -119,14 +119,14 @@ $player = @{
 }
 
 # Adds a NoteProperty `Status` with the same value from $player to $player.Partner
-$partner = $john | select Status -ExpandProperty Partner
+$partner = $player | select Status -ExpandProperty Partner
 
-[object]::ReferenceEquals($partner, $john.Child) # True
+[object]::ReferenceEquals($partner, $john.Partner) # True # [!code highlight]
 
-$child | gm -MemberType NoteProperty # Status
+$partner | gm -MemberType NoteProperty # Status
 
 $partner.Status # Empowered # . accessor prefers ETS property
-$partner['Status'] # Poisoned
+$partner['Status'] # Poisoned, from the hashtable
 ```
 
 > [!NOTE]

docs/document/Skill/PowerShell/docs/Type System/Extended Type System.md

@@ -14,30 +14,46 @@ There's two kinds of intrinsic members in PowerShell
 - Object views: the mapping of a certain object.
 - Property and methods: intrinsic properties and methods.
 
-All objects in PowerShell have five **object views** members:
+### Object Views
 
-- `psobject`: a `MemberSet` containing reflection source of members.
+Powershell distributes members to three parts for each object: *extended*, *adapted* and *base*.
 
+- `psobject`: a `MemberSet` containing reflection source of members.
+    - `psobject.baseobject`: a reference of the object itself.
+    - `psobject.properties`: all properties from all sources(extended, adapted and base)
+    - `psobject.members`: all members(including properties) from all sources(extended, adapted and base)
+    - `psobject.methods`: all methods from type definition(such as `.NET` type), including raw methods of properties and indexers.
     ```ps1
     $foo = 'I am foo'
     [object]::ReferenceEquals($foo, $foo.psobject.BaseObject) # True
     ```
-- `psbase`: a `MemberSet` containing members of the object being wrapped.
-
+- `psbase`: a `MemberSet` containing members of the **original object**.
+    - the base members are defined ahead of time such as `.NET` types.
+- `psadapted`: a `MemberSet` containing adapted members added by ETS.
+    - members appended dedicatedly for a type **by all means**.
     ```ps1
-    $foo = 'I am foo'
-    [object]::ReferenceEquals($foo.ToString, $foo.psbase.ToString) # True
+    $x = [System.Xml.XmlDocument]::new()
+    $x.LoadXml("<foo><bar>123</bar></foo>")
+    $x.psadapted.foo.bar # 123 # [!code highlight]
     ```
-
-- `psadapted`: a `MemberSet` containing adapted members added by ETS.
 - `psextended`: a `MemberSet` containing extended members **added at runtime**.
+    - properties appended dynamically(conditionally) are extended property, such as `PSPath` for `[FileSystemInfo]` created from item cmdlets.
+    - properties of a `[pscustomobject]` are extended properties.
 - `pstypenames`: a `CodeProperty` equivalent to `psobject.TypeNames`. Returns a collection containing the type names of inheritance chain.
 
     ```ps1
     $foo = 'I am foo'
     [object]::ReferenceEquals($foo.psobject.TypeNames, $foo.pstypenames) # True
     ```
 
+#### Member Priority
+
+1. `psextended`
+2. `psadapted`
+3. `psbase`
+
+### Intrinsic Methods
+
 Intrinsic methods and properties are to mimic singular object and collection in a same form.
 - `Where`: a method for filtering or slicing by condition. See [Where](../Object Manipulation/3.Where.md)
 - `ForEach`: a method to perform iteration with certain logic or perform casting all items to target type. See [ForEach](../Object Manipulation/4.ForEach.md#Intrinsic%20ForEach)