about_Foreach

  • Articolo

Descrizione breve

Descrive un comando linguistico che è possibile usare per attraversare tutti gli elementi in una raccolta di elementi.

Descrizione lunga

L'istruzione foreach è un costrutto di linguaggio per l'iterazione su un set di valori in una raccolta.

Il tipo più semplice e tipico di raccolta da attraversare è una matrice. All'interno di un foreach ciclo, è comune eseguire uno o più comandi per ogni elemento in una matrice.

Sintassi

Di seguito è illustrata la foreach sintassi:

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

La parte dell'istruzione foreach all'interno delle parentesi rappresenta una variabile e una raccolta da eseguire l'iterazione. PowerShell crea automaticamente la variabile $<item> quando viene eseguito il foreach ciclo. All'inizio di ogni iterazione, foreach imposta la variabile dell'elemento sul valore successivo nella raccolta. Il {<statement list>} blocco contiene i comandi da eseguire per ogni iterazione.

Esempi

Ad esempio, il foreach ciclo nell'esempio seguente visualizza i valori nella $letterArray matrice.

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

In questo esempio, $letterArray contiene i valori astringa , , bce d. La prima volta che l'istruzione foreach viene eseguita, imposta la $letter variabile uguale al primo elemento in $letterArray (a). Usa quindi Write-Host per visualizzare il valore. Alla successiva esecuzione del ciclo viene $letter impostato su b. Il criterio viene ripetuto per ogni elemento nella matrice.

È anche possibile usare foreach istruzioni con cmdlet che restituiscono una raccolta di elementi. Nell'esempio seguente l'istruzione foreach esegue la procedura per scorrere l'elenco di elementi restituiti dal Get-ChildItem cmdlet .

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

È possibile perfezionare l'esempio usando un'istruzione if per limitare i risultati restituiti. Nell'esempio seguente l'istruzione if limita i risultati ai file maggiori di 100 kilobyte (KB):

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

In questo esempio, il foreach ciclo usa una proprietà della $file variabile per eseguire un'operazione di confronto ($file.length -gt 100KB). La $file variabile ha tutte le proprietà dell'oggetto restituito dall'oggetto Get-ChildItem.

Nell'esempio successivo, lo script visualizza la lunghezza e l'ora dell'ultimo accesso all'interno dell'elenco di istruzioni:

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

È anche possibile usare variabili dall'esterno di un foreach ciclo. L'esempio seguente conta i file di dimensioni superiori a 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.'
}

Nell'esempio precedente inizia $i con un valore esterno 0 al ciclo. $i Viene quindi incrementato all'interno del ciclo per ogni file maggiore di 100 KB. Quando il ciclo viene chiuso, un'istruzione if valuta il valore di $i per visualizzare un conteggio di file superiore a 100 KB.

L'esempio precedente illustra anche come formattare i risultati della lunghezza del file:

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

Il valore è diviso per 1.024 per visualizzare i risultati in kilobyte anziché byte e il valore risultante viene quindi formattato utilizzando l'identificatore di formato a virgola fissa per rimuovere i valori decimali dal risultato. l'identificatore 0 di formato non mostra posizioni decimali.

La funzione seguente analizza gli script e i moduli di script di PowerShell e restituisce il percorso delle funzioni contenute all'interno. Nell'esempio viene illustrato come usare il MoveNext metodo e la Current$foreach proprietà della variabile all'interno di un foreach blocco di script.

Per altre informazioni, vedere Uso di enumeratori.

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
    }
  }
}

Vedi anche