mirror of
https://github.com/dfinke/ImportExcel.git
synced 2025-12-06 00:23:20 +00:00
41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
# How to Read an existing Excel File
|
|
|
|
```powershell
|
|
Import-Module ImportExcel
|
|
#Loads the Excel file into a is a custom PS Object
|
|
$ExcelFile = Import-Excel "C:\Test\file.xlsx" -WorksheetName "Sheet1"
|
|
```
|
|
|
|
## Visual of Data Structure
|
|
The File C:\Test\file.xlsx contains
|
|
|
|
|
|
After Loading this data into ```$ExcelFile``` the data is stored like:
|
|
|
|
|
|
## Other Common Operations
|
|
|
|
### Load a Column
|
|
```powershell
|
|
$SpecificColumn = $ExcelFile."anotherHeader" #loads column with the header "another header" store into an array
|
|
```
|
|
|
|
### Load a Row
|
|
```powershell
|
|
$SpecificRow = $ExcelFile[1] #Loads row at index 1. Index 1 is the first row instead of 0.
|
|
```
|
|
|
|
### Map Contents to HashTable to interpret data
|
|
Sometimes mapping to a HashTable is more convenient to have access to common Hashtable operations. Enumerate a HashTable with the Row data properties by:
|
|
```powershell
|
|
$HashTable = @{}
|
|
$SpecificRow= $ExcelFile[2]
|
|
$SpecificRow.psobject.properties | ForEach-Object {$HashTable[$_.Name] = $_.Value}
|
|
```
|
|
To then iterate through the enumerated hash...
|
|
```powershell
|
|
ForEach ($Key in ($HashTable.GetEnumerator()) | Where-Object {$_.Value -eq "x"}){ #Only grabs a key where the value is "x"
|
|
#values accessible with $Key.Name or $Key.Value
|
|
}
|
|
```
|