Объект ISEFile
Объект ISEFile представляет файл в интегрированной среде сценариев Windows PowerShell (ISE). Это экземпляр класса Microsoft.PowerShell.Host.ISE.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 и более поздних версий.
Сохраняет файл с указанным именем файла и кодировкой.
имя файла — строка имя, используемое для сохранения файла.
[saveEncoding] — необязательный System.Text.Encoding необязательный параметр кодировки символов, используемый для сохраненного файла. Значение по умолчанию — UTF8.
Исключения
- System.ArgumentNullException: параметр имени файла имеет значение NULL.
- System.ArgumentException: параметр имени файла пуст.
- 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
См. также
- iseFileCollectionObject
- назначение объектной модели сценариев сценариев Windows PowerShell ISE
- иерархии объектной модели ISE
PowerShell