Поделиться через

Объект ISEFile

  • Статья

Объект ISEFile представляет файл в интегрированной среде сценариев Windows PowerShell (ISE). Он является экземпляром класса Microsoft.PowerShell.Host.ISE.ISEFile. В этом разделе перечислены его члены (методы и свойства). Объект $psISE.CurrentFile и все файлы в коллекции "Файлы" на вкладке PowerShell являются экземплярами класса **Microsoft.PowerShell.Host.ISE.ISEFile.

Методы

Save( [saveEncoding] )

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Сохраняет файл на диске.

[saveEncoding] — необязательный параметр кодировки символов System.Text.Encoding, используемый для сохраненного файла. Значение по умолчанию — UTF8.

Исключения

  • System.IO.IOException: не удалось сохранить файл.
# 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(filename, [saveEncoding])

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Сохраняет файл с указанным именем файла и кодировкой.

filename — строка. Имя, используемое для сохранения файла.

[saveEncoding] — необязательный параметр кодировки символов System.Text.Encoding, используемый для сохраненного файла. Значение по умолчанию — UTF8.

Исключения

  • System.ArgumentNullException: параметр filename имеет значение NULL.
  • System.ArgumentException: параметр filename пуст.
  • System.IO.IOException: не удалось сохранить файл.
# 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)

Свойства

DisplayName

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает строку, содержащую отображаемое имя этого файла. Имя отображается на вкладке Файл в верхней части окна редактора. Наличие звездочки (*) в конце имени указывает, что в файле есть изменения, которые не были сохранены.

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

Редактор

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает объект редактора, используемый для указанного файла.

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

Кодировка

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает исходную кодировку файла. Это объект System.Text.Encoding.

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

FullPath

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает строку, указывающую полный путь к открытому файлу.

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

IsSaved

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Логическое свойство только для чтения, которое возвращает значение $true, если файл был сохранен после последнего изменения.

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

IsUntitled

Поддерживается в интегрированной среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое возвращает значение $true, если для файла не задано имя.

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

См. также