Obiekt ISEFile

  • Artykuł

Obiekt ISEFile reprezentuje plik w zintegrowanym środowisku skryptów środowiska Windows PowerShell (ISE). Jest to wystąpienie klasy Microsoft.PowerShell.Host.ISE.ISEFile . Ten temat zawiera listę metod składowych i właściwości składowych. Pliki $psISE.CurrentFile i w kolekcji Pliki na karcie programu PowerShell to wszystkie wystąpienia klasy **Microsoft.PowerShell.Host.ISE.ISEFile .

Metody

Save( [saveEncoding] )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Zapisuje plik na dysku.

[saveEncoding] — opcjonalny parametr Kodowania System.Text.Encoding opcjonalny parametr kodowania znaków, który ma być używany dla zapisanego pliku. Wartość domyślna to UTF8.

Wyjątki

  • System.IO.IOException: Nie można zapisać pliku.
# Save the file using the default encoding (UTF8)
$psISE.CurrentFile.Save()

# Save the file as ASCII.
$psISE.CurrentFile.Save([System.Text.Encoding]::ASCII)

# Gets the current encoding.
$myfile = $psISE.CurrentFile
$myfile.Encoding

SaveAs(nazwa pliku, [saveEncoding])

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Zapisuje plik z określoną nazwą pliku i kodowaniem.

nazwa pliku — ciąg nazwa, która ma zostać użyta do zapisania pliku.

[saveEncoding] — opcjonalny parametr Kodowania System.Text.Encoding opcjonalny parametr kodowania znaków, który ma być używany dla zapisanego pliku. Wartość domyślna to UTF8.

Wyjątki

  • System.ArgumentNullException: parametr nazwy pliku ma wartość null.
  • System.ArgumentException: parametr nazwy pliku jest pusty.
  • System.IO.IOException: Nie można zapisać pliku.
# Save the file with a full path and name.
$fullpath = "c:\temp\newname.txt"
$psISE.CurrentFile.SaveAs($fullPath)
# Save the file with a full path and name and explicitly as UTF8.
$psISE.CurrentFile.SaveAs($fullPath, [System.Text.Encoding]::UTF8)

Właściwości

DisplayName

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera ciąg zawierający nazwę wyświetlaną tego pliku. Nazwa jest wyświetlana na karcie Plik w górnej części edytora. Obecność gwiazdki (*) na końcu nazwy wskazuje, że plik ma zmiany, które nie zostały zapisane.

# Shows the display name of the file.
$psISE.CurrentFile.DisplayName

Redaktor

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera obiekt edytora używany dla określonego pliku.

# Gets the editor and the text.
$psISE.CurrentFile.Editor.Text

Kodowanie

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera kodowanie oryginalnego pliku. Jest to obiekt System.Text.Encoding .

# Shows the encoding for the file.
$psISE.CurrentFile.Encoding

FullPath

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera ciąg określający pełną ścieżkę otwartego pliku.

# Shows the full path for the file.
$psISE.CurrentFile.FullPath

IsSaved

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość logiczna tylko do odczytu, która zwraca $true wartość, jeśli plik został zapisany po ostatniej modyfikacji.

# Determines whether the file has been saved since it was last modified.
$myfile = $psISE.CurrentFile
$myfile.IsSaved

IsUntitled

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która zwraca $true , jeśli plik nigdy nie otrzymał tytułu.

# Determines whether the file has never been given a title.
$psISE.CurrentFile.IsUntitled
$psISE.CurrentFile.SaveAs("temp.txt")
$psISE.CurrentFile.IsUntitled

Zobacz też