about_Foreach

發行項
03/19/2024

簡短描述

描述可用來周遊專案集合中所有項目的語言命令。

詳細描述

foreach語句是一種語言建構，用於逐一查看集合中的一組值。

要周遊的最簡單且最典型的集合類型是陣列。在 foreach 迴圈中，通常會對陣列中的每個項目執行一或多個命令。

語法

下列顯示 foreach 語法：

foreach ($<item> in $<collection>){<statement list>}

括弧內的語句部分 foreach 代表要反覆運算的變數和集合。 PowerShell 會在循環執行時foreach自動建立變數$<item>。在每個反覆項目開始時， foreach 將專案變數設定為集合中的下一個值。區塊 {<statement list>} 包含針對每個反覆項目執行的命令。

範例

例如， foreach 下列範例中的循環會顯示陣列中的 $letterArray 值。

$letterArray = 'a','b','c','d'
foreach ($letter in $letterArray)
{
  Write-Host $letter
}

在這裡範例中， $letterArray 包含字串值 a、 b、 c和 d。語句第一次foreach執行時，它會將變數設定$letter為等於（a）中的$letterArray第一個專案。然後，它會使用 Write-Host 來顯示值。下次透過循環時， $letter 會設定為 b。此模式會針對數位中的每個項目重複。

您也可以搭配傳回專案集合的 Cmdlet 使用 foreach 語句。在下列範例中 foreach ，語句會逐步執行 Cmdlet 所 Get-ChildItem 傳回的項目清單。

foreach ($file in Get-ChildItem)
{
  Write-Host $file
}

您可以使用語句來精簡範例 if ，以限制傳回的結果。在下列範例中，語句會將 if 結果限製為大於 100 KB 的檔案（KB）：

foreach ($file in Get-ChildItem)
{
  if ($file.Length -gt 100KB)
  {
    Write-Host $file
  }
}

在此範例中，迴圈會 foreach 使用變數的 $file 屬性來執行比較作業（$file.length -gt 100KB）。變數 $file 具有所 Get-ChildItem傳回之物件的所有屬性。

在下一個範例中，腳本會顯示語句清單內的長度和上次存取時間：

foreach ($file in Get-ChildItem)
{
  if ($file.Length -gt 100KB)
  {
    Write-Host $file
    Write-Host $file.Length
    Write-Host $file.LastAccessTime
  }
}

您也可以使用循環外部的 foreach 變數。下列範例會計算大小超過 100 KB 的檔案：

$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 100KB in the current directory.'
}
else {
  Write-Host 'No files greater than 100KB in the current directory.'
}

在上述範例中， $i 從迴圈外部的值 0 開始。然後， $i 會針對大於 100KB 的每個檔案，在迴圈內遞增。循環結束時， if 語句會評估的值 $i ，以顯示超過 100 KB 的檔案計數。

上述範例也會示範如何格式化檔案長度結果：

($file.length / 1024).ToString('F0')

此值會除以 1,024 以顯示以 KB 而非位元組為單位的結果，然後產生的值會使用固定點格式規範來格式化，以從結果中移除任何十進位值。會 0 讓格式規範顯示沒有小數字數。

下列函式會剖析 PowerShell 腳本和腳本模組，並傳回所包含的函式位置。此範例示範如何在腳本區塊內foreach使用 MoveNext 變數的方法和 Current 屬性$foreach。

如需詳細資訊，請參閱使用列舉值。

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 {
        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
          }
          $addMemberSplat = @{
              InputObject = $functionPosition
              TypeName = 'FunctionPosition'
              PassThru = $true
          }
          Add-Member @addMemberSplat
        }
      }
    }
    catch {
      throw
    }
  }
}

共用方式為

about_Foreach

簡短描述

詳細描述

語法

範例

另請參閱

其他資源