about_Arrays

Artikel
05/09/2024

Korte beschrijving

Hierin worden matrices beschreven. Dit zijn gegevensstructuren die zijn ontworpen voor het opslaan van verzamelingen items.

Lange beschrijving

Een matrix is een gegevensstructuur die is ontworpen om een verzameling items op te slaan. De items kunnen van hetzelfde type of verschillende typen zijn.

Vanaf Windows PowerShell 3.0 heeft een verzameling van nul of één object enkele eigenschappen van matrices.

Een matrix maken en initialiseren

Als u een matrix wilt maken en initialiseren, wijst u meerdere waarden toe aan een variabele. De waarden die zijn opgeslagen in de matrix worden gescheiden door een komma en gescheiden van de naam van de variabele door de toewijzingsoperator (=).

Als u bijvoorbeeld een matrix met de naam $A wilt maken die de zeven numerieke waarden (geheel getal) van 22, 5, 10, 8, 12, 9 en 80 bevat, typt u:

$A = 22,5,10,8,12,9,80

De komma kan ook worden gebruikt om een matrix met één item te initialiseren door de komma vóór het item te plaatsen.

Als u bijvoorbeeld één itemmatrix met de naam $B wilt maken met de enkele waarde 7, typt u:

$B = ,7

U kunt ook een matrix maken en initialiseren met behulp van de bereikoperator (..). In het volgende voorbeeld wordt een matrix gemaakt met de waarden 5 tot en met 8.

$C = 5..8

Als resultaat $C bevat vier waarden: 5, 6, 7 en 8.

Wanneer er geen gegevenstype is opgegeven, maakt PowerShell elke matrix als een objectmatrix (System.Object[]). Gebruik GetType() de methode om het gegevenstype van een matrix te bepalen. Bijvoorbeeld:

$A.GetType()

Als u een sterk getypte matrix wilt maken, dat wil gezegd een matrix die alleen waarden van een bepaald type kan bevatten, moet u de variabele casten als een matrixtype, zoals string[], long[] of int32[]. Als u een matrix wilt casten, gaat u voor de naam van de variabele een matrixtype tussen vierkante haken. Bijvoorbeeld:

[int32[]]$ia = 1500, 2230, 3350, 4000

Als gevolg hiervan kan de $ia matrix alleen gehele getallen bevatten.

U kunt matrices maken die worden gecast naar elk ondersteund type in .NET. De objecten die Get-Process worden opgehaald om processen te vertegenwoordigen, zijn bijvoorbeeld van het type System.Diagnostics.Process . Als u een sterk getypte matrix van procesobjecten wilt maken, voert u de volgende opdracht in:

[Diagnostics.Process[]]$zz = Get-Process

De operator voor de subexpressie van de matrix

De operator voor de subexpressie van de matrix maakt een matrix op basis van de instructies in de matrix. Wat de instructie in de operator ook produceert, de operator plaatst deze in een matrix. Zelfs als er nul of één object is.

De syntaxis van de matrixoperator is als volgt:

@( ... )

U kunt de matrixoperator gebruiken om een matrix van nul of één object te maken. Bijvoorbeeld:

$a = @("Hello World")
$a.Count

$b = @()
$b.Count

De matrixoperator is handig in scripts wanneer u objecten ophaalt, maar niet weet hoeveel u kunt verwachten. Bijvoorbeeld:

$p = @(Get-Process Notepad)

Zie about_Operators voor meer informatie over de operator voor matrixsubexpressie.

Matrixelementen openen en gebruiken

Een matrix lezen

U kunt naar een matrix verwijzen met de naam van de variabele. Als u alle elementen in de matrix wilt weergeven, roept u de matrixnaam aan. Is bijvoorbeeld $a een matrix van de getallen 0 tot en met 9:

$a

U kunt verwijzen naar de elementen in een matrix met behulp van een index. Plaats het indexnummer tussen vierkante haken. Indexwaarden beginnen bij 0. Als u bijvoorbeeld het eerste element in de $a matrix wilt weergeven, typt u:

$a[0]

Als u het derde element in de $a matrix wilt weergeven, typt u:

$a[2]

U kunt een deel van de matrix ophalen met behulp van een bereikoperator voor de index. Als u bijvoorbeeld de tweede tot vijfde elementen van de matrix wilt ophalen, typt u:

$a[1..4]

Negatieve getallen tellen vanaf het einde van de matrix. Verwijst bijvoorbeeld -1 naar het laatste element van de matrix. Als u de laatste drie elementen van de matrix wilt weergeven, in oplopende indexvolgorde, typt u:

$a = 0 .. 9
$a[-3..-1]

7
8
9

Als u negatieve indexen in aflopende volgorde typt, verandert de uitvoer.

$a = 0 .. 9
$a[-1..-3]

9
8
7

Wees echter voorzichtig bij het gebruik van deze notatie. De notatiecycli van de eindgrens tot het begin van de matrix.

$a = 0 .. 9
$a[2..-2]

Een veelvoorkomende fout is ook te veronderstellen dat $a[0..-2] verwijst naar alle elementen van de matrix, met uitzondering van de laatste. Het verwijst naar de eerste, laatste en op een na laatste elementen in de matrix.

U kunt de plus-operator (+) gebruiken om een bereik te combineren met een lijst met elementen in een matrix. Als u bijvoorbeeld de elementen op indexposities 0, 2 en 4 tot en met 6 wilt weergeven, typt u:

$a = 0 .. 9
$a[0,2+4..6]

Als u meerdere bereiken en afzonderlijke elementen wilt weergeven, kunt u ook de plus-operator gebruiken. Als u bijvoorbeeld de elementen nul tot twee, vier tot zes en het element op achtste positie wilt weergeven, gaat u als volgt te werk:

$a = 0..9
$a[+0..2+4..6+8]

Iteraties op matrixelementen

U kunt ook lusconstructies, zoals foreach, foren while lussen, gebruiken om te verwijzen naar de elementen in een matrix. Als u bijvoorbeeld een foreach lus wilt gebruiken om de elementen in de $a matrix weer te geven, typt u:

$a = 0..9
foreach ($element in $a) {
  $element
}

De foreach lus doorloopt de matrix en retourneert elke waarde in de matrix totdat het einde van de matrix is bereikt.

De for lus is handig wanneer u tellers oploopt tijdens het onderzoeken van de elementen in een matrix. Als u bijvoorbeeld een for lus wilt gebruiken om elke andere waarde in een matrix te retourneren, typt u:

$a = 0..9
for ($i = 0; $i -le ($a.length - 1); $i += 2) {
  $a[$i]
}

U kunt een while lus gebruiken om de elementen in een matrix weer te geven totdat een gedefinieerde voorwaarde niet meer waar is. Als u bijvoorbeeld de elementen in de $a matrix wilt weergeven terwijl de matrixindex kleiner is dan 4, typt u:

$a = 0..9
$i=0
while($i -lt 4) {
  $a[$i]
  $i++
}

Eigenschappen van matrices

Countof of LengthLongLength

Gebruik de eigenschap of Count de Length alias om te bepalen hoeveel items zich in een matrix bevinden. Longlength is handig als de matrix meer dan 2.147.483.647 elementen bevat.

$a = 0..9
$a.Count
$a.Length

10
10

Rank

Retourneert het aantal dimensies in de matrix. De meeste matrices in PowerShell hebben slechts één dimensie. Zelfs als u denkt dat u een multidimensionale matrix maakt, zoals in het volgende voorbeeld:

$a = @(
  @(0,1),
  @("b", "c"),
  @(Get-Process)
)

"`$a rank: $($a.Rank)"
"`$a length: $($a.Length)"
"`$a[2] length: $($a[2].Length)"
"Process `$a[2][1]: $($a[2][1].ProcessName)"

In dit voorbeeld maakt u een eendimensionale matrix die andere matrices bevat. Dit wordt ook wel een onregelmatige matrix genoemd. De Rank eigenschap bewees dat dit eendimensionaal is. Voor toegang tot items in een gekartelde matrix moeten de indexen tussen afzonderlijke haken () staan.[]

$a rank: 1
$a length: 3
$a[2] length: 348
Process $a[2][1]: AcroRd32

Multidimensionale matrices worden opgeslagen in rij-primaire volgorde. In het volgende voorbeeld ziet u hoe u een echt multidimensionale matrix maakt.

[string[,]]$rank2 = [string[,]]::New(3,2)
$rank2.rank
$rank2.Length
$rank2[0,0] = 'a'
$rank2[0,1] = 'b'
$rank2[1,0] = 'c'
$rank2[1,1] = 'd'
$rank2[2,0] = 'e'
$rank2[2,1] = 'f'
$rank2[1,1]

2
6
d

Als u toegang wilt krijgen tot items in een multidimensionale matrix, scheidt u de indexen met behulp van een komma (,) binnen één set vierkante haken ([]).

Voor sommige bewerkingen op een multidimensionale matrix, zoals replicatie en samenvoeging, moet die matrix worden afgevlakt. Door afvlakking wordt de matrix omgezet in een 1-dimensionale matrix van een ongeconstraind type. De resulterende matrix neemt alle elementen op in rij-primaire volgorde. Kijk eens naar het volgende voorbeeld:

$a = "red",$true
$b = (New-Object 'int[,]' 2,2)
$b[0,0] = 10
$b[0,1] = 20
$b[1,0] = 30
$b[1,1] = 40
$c = $a + $b
$a.GetType().Name
$b.GetType().Name
$c.GetType().Name
$c

De uitvoer laat zien dat $c het een 1-dimensionale matrix is die de items uit $a en $b in rij-primaire volgorde bevat.

Object[]
Int32[,]
Object[]
red
True
10
20
30
40

Methoden van matrices

Clear

Hiermee stelt u alle elementwaarden in op de standaardwaarde van het elementtype van de matrix. Met Clear() de methode wordt de grootte van de matrix niet opnieuw ingesteld.

In het volgende voorbeeld $a ziet u een matrix met objecten.

$a = 1, 2, 3
$a.Clear()
$a | % { $null -eq $_ }

True
True
True

In dit voorbeeld $intA wordt expliciet getypt om gehele getallen te bevatten.

[int[]] $intA = 1, 2, 3
$intA.Clear()
$intA

0
0
0

ForEach()

Hiermee kunt u alle elementen in de matrix herhalen en een bepaalde bewerking uitvoeren voor elk element van de matrix.

De ForEach() methode heeft verschillende overloads die verschillende bewerkingen uitvoeren.

ForEach(scriptblock expression)
ForEach(scriptblock expression, object[] arguments)
ForEach(type convertToType)
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
ForEach(string methodName)
ForEach(string methodName, object[] arguments)

ForEach(scriptblock-expressie)

ForEach(scriptblock-expressie, object[] argumenten)

Deze methode is toegevoegd in PowerShell v4.

Notitie

De syntaxis vereist het gebruik van een scriptblok. Haakjes zijn optioneel als het scriptblok de enige parameter is. Er mag ook geen spatie zijn tussen de methode en het haakje openen of accolade.

In het volgende voorbeeld ziet u hoe u de ForEach() methode gebruikt. In dit geval is het de bedoeling om de kwadratische waarde van de elementen in de matrix te genereren.

$a = @(0 .. 3)
$a.ForEach({ $_ * $_})

Net als de parameter ArgumentList van ForEach-Objectstaat de arguments parameter toe dat een matrix met argumenten wordt doorgegeven aan een scriptblok dat is geconfigureerd om deze te accepteren.

Zie about_Splatting voor meer informatie over het gedrag van ArgumentList.

ForEach(typ convertToType)

De ForEach() methode kan worden gebruikt om de elementen naar een ander type te casten. In het volgende voorbeeld ziet u hoe u een lijst met tekenreeksdatums converteert naar [DateTime] type.

("1/1/2017", "2/1/2017", "3/1/2017").ForEach([datetime])


Sunday, January 1, 2017 12:00:00 AM
Wednesday, February 1, 2017 12:00:00 AM
Wednesday, March 1, 2017 12:00:00 AM

ForEach(tekenreeks propertyName)

ForEach(tekenreeks propertyName, object[] newValue)

De ForEach() methode kan ook worden gebruikt om eigenschapswaarden op te halen of in te stellen voor elk item in de verzameling.

# Set all LastAccessTime properties of files to the current date.
(dir 'C:\Temp').ForEach('LastAccessTime', (Get-Date))
# View the newly set LastAccessTime of all items, and find Unique entries.
(dir 'C:\Temp').ForEach('LastAccessTime') | Get-Unique

Wednesday, June 20, 2018 9:21:57 AM

ForEach(string methodName)

ForEach(string methodName, object[] argumenten)

Lastly, ForEach() methoden kunnen worden gebruikt om een methode uit te voeren op elk item in de verzameling.

("one", "two", "three").ForEach("ToUpper")

ONE
TWO
THREE

Net als de parameter ArgumentList van ForEach-Objectstaat de arguments parameter het doorgeven van een matrix met waarden toe aan een scriptblok dat is geconfigureerd om deze te accepteren.

Notitie

Vanaf Windows PowerShell 3.0 kan het ophalen van eigenschappen en het uitvoeren van methoden voor elk item in een verzameling ook worden uitgevoerd met behulp van 'Methoden van scalaire objecten en verzamelingen'. U kunt hier about_Methods meer over lezen.

Where()

Hiermee kunt u de elementen van de matrix filteren of selecteren. Het script moet resulteren in iets anders dan: nul (0), lege tekenreeks $false of $null om ervoor te zorgen dat het element wordt weergegeven na de Where(). Zie about_Booleans voor meer informatie over booleaanse evaluatie.

Er is één definitie voor de Where() methode.

Where(scriptblock expression[, WhereOperatorSelectionMode mode
                            [, int numberToReturn]])

Notitie

De syntaxis vereist het gebruik van een scriptblok. Haakjes zijn optioneel als het scriptblok de enige parameter is. Er mag ook geen spatie zijn tussen de methode en het haakje openen of accolade.

De Expression is een scriptblok dat is vereist voor filteren, het mode optionele argument biedt aanvullende selectiemogelijkheden en het numberToReturn optionele argument maakt het mogelijk om te beperken hoeveel items worden geretourneerd uit het filter.

De waarde van mode moet een WhereOperatorSelectionMode enum-waarde zijn:

Default (0) - Retourneer alle items
First (1) - Retourneer het eerste item
Last (2) - Retourneer het laatste item
SkipUntil (3) - Sla items over totdat de voorwaarde waar is, retourneer alle resterende items (inclusief het eerste item waarvoor de voorwaarde waar is)
Until (4) - Retourneer alle items totdat voorwaarde waar is
Split (5) - Retourneert een matrix van twee elementen
- Het eerste element bevat overeenkomende items
- Het tweede element bevat de resterende items

In het volgende voorbeeld ziet u hoe u alle oneven getallen uit de matrix selecteert.

(0..9).Where{ $_ % 2 }

In dit voorbeeld ziet u hoe u tekenreeksen selecteert die niet leeg zijn.

('hi', '', 'there').Where({$_.Length})

hi
there

Default

De Default modus filtert items met behulp van het Expression scriptblock.

Als er een numberToReturn is opgegeven, wordt het maximum aantal items opgegeven dat moet worden geretourneerd.

# Get the zip files in the current users profile, sorted by LastAccessTime
$Zips = dir $env:userprofile -Recurse '*.zip' | Sort-Object LastAccessTime
# Get the least accessed file over 100MB
$Zips.Where({$_.Length -gt 100MB}, 'Default', 1)

Notitie

Zowel de modus als First de Default modus retourneren de eerste (numberToReturn) items en kunnen door elkaar worden gebruikt.

Last

$h = (Get-Date).AddHours(-1)
$logs = dir 'C:\' -Recurse '*.log' | Sort-Object CreationTime
# Find the last 5 log files created in the past hour
$logs.Where({$_.CreationTime -gt $h}, 'Last', 5)

SkipUntil

In de SkipUntil modus worden alle objecten in een verzameling overgeslagen totdat een object het scriptblokexpressiefilter doorgeeft. Vervolgens worden ALLE resterende verzamelingsitems geretourneerd zonder deze te testen. Er wordt slechts één passerend item getest.

Dit betekent dat de geretourneerde verzameling zowel doorgevende als niet-doorgegeven items bevat die NIET zijn getest.

Het aantal geretourneerde items kan worden beperkt door een waarde door te geven aan het numberToReturn argument.

$computers = "Server01", "Server02", "Server03", "localhost", "Server04"
# Find the first available online server.
$computers.Where({ Test-Connection $_ }, 'SkipUntil', 1)

localhost

Until

De Until modus keert de SkipUntil modus om. Hiermee worden ALLE items in een verzameling geretourneerd totdat een item de scriptblokexpressie doorgeeft. Zodra een item de scriptblock-expressie doorgeeft , stopt de methode met het Where() verwerken van items.

Dit betekent dat u de eerste set niet-doorgegeven items van de Where() methode ontvangt. Nadat één item is geslaagd, wordt de rest NIET getest of geretourneerd.

Het aantal geretourneerde items kan worden beperkt door een waarde door te geven aan het numberToReturn argument.

# Retrieve the first set of numbers less than or equal to 10.
(1..50).Where({$_ -gt 10}, 'Until')
# This would perform the same operation.
(1..50).Where({$_ -le 10})

Notitie

Zowel Until als SkipUntil werken onder de premisse van het NIET testen van een batch met items.

Until retourneert de items VÓÓR de eerste PASS. SkipUntil retourneert alle items NA de eerste pas, inclusief het eerste passerende item.

Split

De Split modus splitst of groepeert verzamelingsitems in twee afzonderlijke verzamelingen. Degenen die de scriptblock-expressie doorgeven en degenen die dat niet doen.

Als een numberToReturn is opgegeven, bevat de eerste verzameling de doorgegeven items, zodat de opgegeven waarde niet wordt overschreden.

De resterende objecten, zelfs de objecten die het expressiefilter DOORGEVEN , worden geretourneerd in de tweede verzameling.

$running, $stopped = (Get-Service).Where({$_.Status -eq 'Running'}, 'Split')
$running

Status   Name               DisplayName
------   ----               -----------
Running  Appinfo            Application Information
Running  AudioEndpointBu... Windows Audio Endpoint Builder
Running  Audiosrv           Windows Audio
...

$stopped

Status   Name               DisplayName
------   ----               -----------
Stopped  AJRouter           AllJoyn Router Service
Stopped  ALG                Application Layer Gateway Service
Stopped  AppIDSvc           Application Identity
...

Notitie

Where() Zowel methoden als ForEach() methoden zijn intrinsieke leden. Zie about_Instrinsic_Members voor meer informatie over intrinsieke leden.

De leden van een matrix ophalen

Als u de eigenschappen en methoden van een matrix wilt ophalen, zoals de Length eigenschap en de methode SetValue , gebruikt u de parameter InputObject van de Get-Member cmdlet.

Wanneer u een matrix doorstuurt naar Get-Member, verzendt PowerShell de items één voor één en Get-Member retourneert het type van elk item in de matrix (dubbele waarden worden genegeerd).

Wanneer u de parameter InputObject gebruikt, Get-Member worden de leden van de matrix geretourneerd.

Met de volgende opdracht worden bijvoorbeeld de leden van de $a matrixvariabele ophaalt.

Get-Member -InputObject $a

U kunt de leden van een matrix ook ophalen door een komma (,) te typen vóór de waarde die naar de Get-Member cmdlet wordt doorgesluisd. De komma maakt de matrix het tweede item in een matrix met matrices. PowerShell pijpt de matrices een voor een en Get-Member retourneert de leden van de matrix. Zoals in de volgende twee voorbeelden.

,$a | Get-Member

,(1,2,3) | Get-Member

Een matrix bewerken

U kunt de elementen in een matrix wijzigen, een element toevoegen aan een matrix en de waarden van twee matrices combineren tot een derde matrix.

Als u de waarde van een bepaald element in een matrix wilt wijzigen, geeft u de matrixnaam en de index op van het element dat u wilt wijzigen en gebruikt u vervolgens de toewijzingsoperator (=) om een nieuwe waarde voor het element op te geven. Als u bijvoorbeeld de waarde van het tweede item in de $a matrix (indexpositie 1) wilt wijzigen in 10, typt u:

$a[1] = 10

U kunt ook de methode SetValue van een matrix gebruiken om een waarde te wijzigen. In het volgende voorbeeld wordt de tweede waarde (indexpositie 1) van de $a matrix gewijzigd in 500:

$a.SetValue(500,1)

U kunt de += operator gebruiken om een element toe te voegen aan een matrix. In het volgende voorbeeld ziet u hoe u een element toevoegt aan de $a matrix.

$a = @(0..4)
$a += 5

Notitie

Wanneer u de += operator gebruikt, maakt PowerShell in feite een nieuwe matrix met de waarden van de oorspronkelijke matrix en de toegevoegde waarde. Dit kan prestatieproblemen veroorzaken als de bewerking meerdere keren wordt herhaald of als de grootte van de matrix te groot is.

Het is niet eenvoudig om elementen uit een matrix te verwijderen, maar u kunt een nieuwe matrix maken die alleen geselecteerde elementen van een bestaande matrix bevat. Als u bijvoorbeeld de $t matrix wilt maken met alle elementen in de $a matrix behalve de waarde op indexpositie 2, typt u:

$t = $a[0,1 + 3..($a.length - 1)]

Als u twee matrices wilt combineren tot één matrix, gebruikt u de plus-operator (+). In het volgende voorbeeld worden twee matrices gemaakt, gecombineerd en vervolgens de resulterende gecombineerde matrix weergegeven.

$x = 1,3
$y = 5,9
$z = $x + $y

Als gevolg hiervan bevat de $z matrix 1, 3, 5 en 9.

Als u een matrix wilt verwijderen, wijst u een waarde van $null toe aan de matrix. Met de volgende opdracht wordt de matrix in de $a variabele verwijderd.

$a = $null

U kunt ook de Remove-Item cmdlet gebruiken, maar het toewijzen van een waarde van $null is sneller, met name voor grote matrices.

Matrices van nul of één

Vanaf Windows PowerShell 3.0 heeft een verzameling van nul of één object de Count eigenschappen enLength. U kunt ook indexeren in een matrix van één object. Met deze functie kunt u scriptfouten voorkomen die optreden wanneer een opdracht die een verzameling verwacht minder dan twee items krijgt.

In het volgende voorbeeld ziet u dat een variabele die geen objecten bevat een Count en Length van 0 heeft.

PS> $a = $null
PS> $a.Count
0
PS> $a.Length
0

In het volgende voorbeeld ziet u dat een variabele met één object een Count en Length van 1 heeft. U kunt matrixindexering ook gebruiken om toegang te krijgen tot de waarde van het object.

PS> $a = 4
PS> $a.Count
1
PS> $a.Length
1
PS> $a[0]
4
PS> $a[-1]
4

Wanneer u een opdracht uitvoert waarmee een verzameling of één object kan worden geretourneerd, kunt u matrixindexering gebruiken om toegang te krijgen tot de waarde van het object zonder dat u de Count eigenschappen of Length hoeft te testen. Als het resultaat echter één object (singleton) is en dat object een Count eigenschap of Length heeft, behoort de waarde van die eigenschappen tot het singletonobject en vertegenwoordigt deze niet het aantal items in de verzameling.

In het volgende voorbeeld retourneert de opdracht één tekenreeksobject. De Length van die tekenreeks is 4.

PS> $result = 'one','two','three','four' | Where-Object {$_ -like 'f*'}
PS> $result.GetType().FullName
System.String
PS> $result
four
PS> $result.Count
1
PS❯ $result.Length
4

Als u een matrix van tekenreeksen wilt $result zijn, moet u de variabele declareren als een matrix.

In dit voorbeeld $result is een matrix van tekenreeksen. De Count en Length van de matrix is 1, en de Length van het eerste element is 4.

PS> [string[]]$result = 'one','two','three','four' |
    Where-Object {$_ -like 'f*'}
PS> $result.GetType().FullName
System.String[]
PS> $result
four
PS> $result.Count
1
PS> $result.Length
1
PS> $result[0].Length
4

Indexeringsondersteuning voor System.Tuple Objecten

PowerShell 6.1 heeft de ondersteuning toegevoegd voor geïndexeerde toegang tot Tuple objecten, vergelijkbaar met matrices. Bijvoorbeeld:

PS> $tuple = [Tuple]::Create(1, 'test')
PS> $tuple[0]
1
PS> $tuple[1]
test
PS> $tuple[0..1]
1
test
PS> $tuple[-1]
test

In tegenstelling tot matrices en andere verzamelingsobjecten worden Tuple objecten behandeld als één object wanneer ze worden doorgegeven via de pijplijn of door parameters die matrices van objecten ondersteunen.

Zie System.voorTuple meer informatie.

Indexering van .NET-typen die implementeren `IDictionary<TKey, TValue>`

PowerShell roept geen echte indexeerfunctie van een type aan voor typen die de algemene IDictionary<TKey, TValue> interface implementeren. In plaats daarvan, wanneer een sleutel wordt gegeven, test PowerShell op het bestaan van de sleutel met behulp van TryGetValue(), die wordt geretourneerd $null wanneer de sleutel niet bestaat.

Als u daarentegen de echte indexeerfunctie van het type aanroept met , Item(<key>)genereert de methode een uitzondering wanneer de sleutel niet bestaat.

In het volgende voorbeeld ziet u het verschil.

PS> [Collections.Generic.Dictionary[string, int]]::new()['nosuchkey']
# No output ($null)

PS> [Collections.Generic.Dictionary[string, int]]::new().Item('nosuchkey')
GetValueInvocationException: Exception getting "Item": "The given key 'nosuchkey'
 was not present in the dictionary."

Opsomming voor toegang tot leden

Vanaf PowerShell 3.0, wanneer u de operator voor lidtoegang gebruikt om toegang te krijgen tot een lid dat niet bestaat in een lijstverzameling, inventariseert PowerShell automatisch de items in de verzameling en probeert toegang te krijgen tot het opgegeven lid voor elk item. Zie about_Member-Access_Enumeration voor meer informatie.

Voorbeelden

In het volgende voorbeeld worden twee nieuwe bestanden gemaakt en worden de resulterende objecten opgeslagen in de matrixvariabele $files. Omdat het matrixobject niet het Lastlid WriteTime heeft, wordt de waarde van LastWriteTime geretourneerd voor elk item in de matrix.

$files = (New-Item -Type File -Force '/temp/t1.txt'),
         (New-Item -Force -Type File '/temp/t2.txt')
$files.LastWriteTime

Friday, June 25, 2021 1:21:17 PM
Friday, June 25, 2021 1:21:17 PM

Met opsomming van ledentoegang kunt u waarden ophalen uit items in een verzameling, maar niet om waarden in te stellen voor items in een verzameling. Bijvoorbeeld:

$files.LastWriteTime = (Get-Date).AddDays(-1)

InvalidOperation: The property 'LastWriteTime' cannot be found on this object.
Verify that the property exists and can be set.

Als u de waarden wilt instellen, moet u een methode gebruiken.

$files.set_LastWriteTime((Get-Date).AddDays(-1))
$files.LastWriteTime

Thursday, June 24, 2021 1:23:30 PM
Thursday, June 24, 2021 1:23:30 PM

De set_LastWriteTime() methode is een verborgen lid van het object FileInfo . In het volgende voorbeeld ziet u hoe u leden kunt vinden die een verborgenset methode hebben.

$files | Get-Member | Where-Object Definition -like '*set;*'

   TypeName: System.IO.FileInfo

Name              MemberType Definition
----              ---------- ----------
Attributes        Property   System.IO.FileAttributes Attributes {get;set;}
CreationTime      Property   datetime CreationTime {get;set;}
CreationTimeUtc   Property   datetime CreationTimeUtc {get;set;}
IsReadOnly        Property   bool IsReadOnly {get;set;}
LastAccessTime    Property   datetime LastAccessTime {get;set;}
LastAccessTimeUtc Property   datetime LastAccessTimeUtc {get;set;}
LastWriteTime     Property   datetime LastWriteTime {get;set;}
LastWriteTimeUtc  Property   datetime LastWriteTimeUtc {get;set;}

Waarschuwing

Omdat de methode wordt uitgevoerd voor elk item in de verzameling, moet u voorzichtig zijn bij het aanroepen van methoden met behulp van lidinventarisatie.

Delen via

about_Arrays

Korte beschrijving

Lange beschrijving

Een matrix maken en initialiseren

De operator voor de subexpressie van de matrix

Matrixelementen openen en gebruiken

Een matrix lezen

Iteraties op matrixelementen

Eigenschappen van matrices

Countof of LengthLongLength

Rank

Methoden van matrices

Clear

ForEach()

ForEach(scriptblock-expressie)

ForEach(scriptblock-expressie, object[] argumenten)

ForEach(typ convertToType)

ForEach(tekenreeks propertyName)

ForEach(tekenreeks propertyName, object[] newValue)

ForEach(string methodName)

ForEach(string methodName, object[] argumenten)

Where()

Default

Last

SkipUntil

Until

Split

De leden van een matrix ophalen

Een matrix bewerken

Matrices van nul of één

Indexeringsondersteuning voor System.Tuple Objecten

Indexering van .NET-typen die implementeren `IDictionary<TKey, TValue>`

Opsomming voor toegang tot leden

Voorbeelden

Zie ook

Aanvullende resources

Delen via

about_Arrays

Korte beschrijving

Lange beschrijving

Een matrix maken en initialiseren

De operator voor de subexpressie van de matrix

Matrixelementen openen en gebruiken

Een matrix lezen

Iteraties op matrixelementen

Eigenschappen van matrices

Countof of LengthLongLength

Rank

Methoden van matrices

Clear

ForEach()

ForEach(scriptblock-expressie)

ForEach(scriptblock-expressie, object[] argumenten)

ForEach(typ convertToType)

ForEach(tekenreeks propertyName)

ForEach(tekenreeks propertyName, object[] newValue)

ForEach(string methodName)

ForEach(string methodName, object[] argumenten)

Where()

Default

Last

SkipUntil

Until

Split

De leden van een matrix ophalen

Een matrix bewerken

Matrices van nul of één

Indexeringsondersteuning voor System.Tuple Objecten

Indexering van .NET-typen die implementeren IDictionary<TKey, TValue>

Opsomming voor toegang tot leden

Voorbeelden

Zie ook

Aanvullende resources

Indexering van .NET-typen die implementeren `IDictionary<TKey, TValue>`