ISEFile 对象The ISEFile Object
本文内容
ISEFile 对象，表示 Windows PowerShell® 集成脚本环境 (ISE) 中的文件。它是 Microsoft.PowerShell.Host.ISE.ISEFile 类的实例。本主题列出其成员方法和成员属性。$PsISE.CurrentFile 和 PowerShell 选项卡中的文件集合中的文件是 Microsoft.PowerShell.Host.ISE.ISEFile 类的所有实例。
方法Methods
Save( [saveEncoding] )Save( [saveEncoding] )
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
将该文件保存到磁盘。
[saveEncoding] - 可选 System.Text.Encoding，用于已保存文件的可选字符编码参数。默认值是 UTF8。
例外Exceptions
- 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])SaveAs(filename, [saveEncoding])
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
使用指定的文件名和编码保存文件。
filename - 字符串要用于保存该文件的名称。
[saveEncoding] - 可选 System.Text.Encoding，用于已保存文件的可选字符编码参数。默认值是 UTF8。
例外Exceptions
- 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)
“属性”Properties
DisplayNameDisplayName
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
只读属性，可获取包含此文件显示名称的字符串。名称显示在编辑器顶部的“文件”选项卡上。名称结尾处存在星号 (*)，表示文件具有未保存的更改。
# Shows the display name of the file.$psISE.CurrentFile.DisplayName
编辑器Editor
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
只读属性，可获取用于指定文件的编辑器对象。
# Gets the editor and the text.$psISE.CurrentFile.Editor.Text
编码Encoding
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
只读属性，可获取原始文件编码。这是一个 System.Text.Encoding 对象。
# Shows the encoding for the file.$psISE.CurrentFile.Encoding
FullPathFullPath
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
只读属性，可获取指定已打开文件的完整路径的字符串。
# Shows the full path for the file.$psISE.CurrentFile.FullPath
IsSavedIsSaved
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
只读布尔属性，如果在最后一次修改文件后保存了文件，则返回 $true。
# Determines whether the file has been saved since it was last modified.$myfile = $psISE.CurrentFile$myfile.IsSaved
IsUntitledIsUntitled
在 Windows PowerShell ISE 2.0 和更高版本中受支持。
只读属性，如果从未指定文件标题，则返回 $true。
# Determines whether the file has never been given a title.$psISE.CurrentFile.IsUntitled$psISE.CurrentFile.SaveAs("temp.txt")$psISE.CurrentFile.IsUntitled
