Om ForEach
Kort beskrivning
Beskriver ett språkkommando som du kan använda för att bläddra igenom alla objekt i en samling objekt.
Lång beskrivning
-instruktionen Foreach
(kallas även en Foreach
loop) är en språkkonstruktion för att stega igenom (iterera) en serie värden i en samling objekt.
Den enklaste och mest typiska typen av samling att bläddra i är en matris.
I en Foreach
loop är det vanligt att köra ett eller flera kommandon mot varje objekt i en matris.
Syntax
Följande visar syntaxen ForEach
:
foreach ($<item> in $<collection>){<statement list>}
Den del av -instruktionen ForEach
som omges av parenteser representerar en variabel och en samling som ska iterera. PowerShell skapar variabeln $<item>
automatiskt när loopen Foreach
körs. Före varje iteration via loopen anges variabeln till ett värde i samlingen.
Blocket som följer en Foreach
instruktion {<statement list>}
innehåller en uppsättning kommandon som ska köras mot varje objekt i en samling.
Exempel
Loopen Foreach
i följande exempel visar till exempel värdena i matrisen $letterArray
.
$letterArray = "a","b","c","d"
foreach ($letter in $letterArray)
{
Write-Host $letter
}
I det här exemplet skapas och initieras matrisen $letterArray
med strängvärdena "a"
, "b"
, "c"
och "d"
. Första gången -instruktionen Foreach
körs anger den variabeln $letter
som det första objektet i $letterArray
("a"
). Sedan använder den cmdleten Write-Host
för att visa bokstaven a. Nästa gång genom loopen $letter
är inställd "b"
på , och så vidare. När loopen Foreach
visar bokstaven d avslutar PowerShell loopen.
Hela Foreach
instruktionen måste visas på en enda rad för att köra den som ett kommando i PowerShell-kommandotolken. Hela Foreach
instruktionen behöver inte visas på en enda rad om du placerar kommandot i en .ps1 skriptfil i stället.
Foreach
-instruktioner kan också användas tillsammans med cmdletar som returnerar en samling objekt. I följande exempel stegar Foreach-instruktionen igenom listan över objekt som returneras av cmdleten Get-ChildItem
.
foreach ($file in Get-ChildItem)
{
Write-Host $file
}
Du kan förfina exemplet med hjälp av en If
-instruktion för att begränsa de resultat som returneras. I följande exempel utför -instruktionen Foreach
samma loopningsåtgärd som i föregående exempel, men lägger till en If
instruktion för att begränsa resultatet till filer som är större än 100 kilobyte (KB):
foreach ($file in Get-ChildItem)
{
if ($file.length -gt 100KB)
{
Write-Host $file
}
}
I det här exemplet använder loopen Foreach
en egenskap för variabeln $file
för att utföra en jämförelseåtgärd ($file.length -gt 100KB
). Variabeln $file
innehåller alla egenskaper i objektet som returneras av cmdleten Get-ChildItem
. Därför kan du returnera mer än bara ett filnamn.
I nästa exempel returnerar PowerShell längden och den senaste åtkomsttiden i instruktionslistan:
foreach ($file in Get-ChildItem)
{
if ($file.length -gt 100KB)
{
Write-Host $file
Write-Host $file.length
Write-Host $file.lastaccesstime
}
}
I det här exemplet är du inte begränsad till att köra ett enda kommando i en instruktionslista.
Du kan också använda en variabel utanför en Foreach
loop och öka variabeln i loopen. I följande exempel räknas filer över 100 kB i storlek:
$i = 0
foreach ($file in Get-ChildItem) {
if ($file.length -gt 100KB) {
Write-Host $file "file size:" ($file.length / 1024).ToString("F0") KB
$i = $i + 1
}
}
if ($i -ne 0) {
Write-Host
Write-Host $i " file(s) over 100 KB in the current directory."
}
else {
Write-Host "No files greater than 100 KB in the current directory."
}
I föregående exempel anges variabeln $i
till 0
utanför loopen och variabeln ökas inuti loopen för varje fil som hittas som är större än 100 kB. När loopen avslutas utvärderar en If
-instruktion värdet $i
för för att visa ett antal av alla filer över 100 kB. Eller så visas ett meddelande om att inga filer över 100 kB hittades.
I föregående exempel visas också hur du formaterar fillängdsresultatet:
($file.length / 1024).ToString("F0")
Värdet divideras med 1 024 för att visa resultatet i kilobyte i stället för byte, och det resulterande värdet formateras sedan med hjälp av fastpunktsformatsspecificeraren för att ta bort decimalvärden från resultatet. 0 gör att formatspecificeraren inte visar några decimaler.
I följande exempel parsar den definierade funktionen PowerShell-skript och skriptmoduler och returnerar platsen för funktioner som finns i. Exemplet visar hur du använder MoveNext
metoden (som fungerar på samma sätt skip X
som i en For
loop) och Current
egenskapen för variabeln $foreach
i ett foreach-skriptblock. Exempelfunktionen kan hitta funktioner i ett skript även om det finns ovanligt eller inkonsekvent fördelade funktionsdefinitioner som sträcker sig över flera rader.
Mer information finns i Använda uppräknare.
function Get-FunctionPosition {
[CmdletBinding()]
[OutputType('FunctionPosition')]
param(
[Parameter(Position = 0, Mandatory,
ValueFromPipeline, ValueFromPipelineByPropertyName)]
[ValidateNotNullOrEmpty()]
[Alias('PSPath')]
[System.String[]]
$Path
)
process {
try {
$filesToProcess = if ($_ -is [System.IO.FileSystemInfo]) {
$_
} else {
$filesToProcess = Get-Item -Path $Path
}
$parser = [System.Management.Automation.Language.Parser]
foreach ($item in $filesToProcess) {
if ($item.PSIsContainer -or
$item.Extension -notin @('.ps1', '.psm1')) {
continue
}
$tokens = $errors = $null
$ast = $parser::ParseFile($item.FullName, ([REF]$tokens),
([REF]$errors))
if ($errors) {
$msg = "File '{0}' has {1} parser errors." -f $item.FullName,
$errors.Count
Write-Warning $msg
}
:tokenLoop foreach ($token in $tokens) {
if ($token.Kind -ne 'Function') {
continue
}
$position = $token.Extent.StartLineNumber
do {
if (-not $foreach.MoveNext()) {
break tokenLoop
}
$token = $foreach.Current
} until ($token.Kind -in @('Generic', 'Identifier'))
$functionPosition = [pscustomobject]@{
Name = $token.Text
LineNumber = $position
Path = $item.FullName
}
Add-Member -InputObject $functionPosition `
-TypeName FunctionPosition -PassThru
}
}
}
catch {
throw
}
}
}