ISEFile 对象表示 Windows PowerShell 集成脚本环境 (ISE) 中的文件。它是 Microsoft.PowerShell.Host.ISE.ISEFile 类的一个实例。本主题列出了它的成员方法和成员属性。$psISE.CurrentFile 和 Powershell 选项卡中 Files 集合内的文件均为 Microsoft.PowerShell.Host.ISE.ISEFile 类的实例。

方法

Save(System.Text.Encoding saveEncoding)

将文件保存到磁盘。

saveEncoding
要用于已保存文件的编码。

Exceptions
  • System.IO.IOException：无法保存文件。

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

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

Save()

保存文件。

Exceptions
  • System.IO.IOException：无法保存文件。

# Explicitly save the file. 
$psIse.CurrentFile.save()

SaveAs(string fileName)

用指定的 fileName 保存文件。

fileName
要将文件保存为的名称。该方法的默认编码是 UTF-16。

Exceptions
  • System.ArgumentNullException：fileName 为 null。

  • System.ArgumentException：fileName 为空。

  • System.IO.IOException：无法保存文件。

# Explicitly save the file. 
$fullpath = "c:\temp\newname.txt"
$myfile=$psIse.CurrentFile
$myfile.SaveAs($fullPath)

SaveAs(string fileName, System.Text.Encoding saveEncoding)

用指定的 filename 以指定的编码保存文件。

fileName：
要将文件保存为的名称。可以指定文件的完整路径名。

saveEncoding
要用于保存文件的编码。

Exceptions
  • System.ArgumentNullException：fileName 为 null。

  • System.ArgumentException：fileName 为空。

  • System.IO.IOException：无法保存文件。

# Explicitly save the file as UTF8.
$fullpath = "c:\temp\newname.txt"
$myfile=$psIse.CurrentFile
$myfile.SaveAs($fullPath, [System.Text.Encoding]::UTF8)
# Gets the current encoding.
$myfile=$psIse.CurrentFile
$myfile.Encoding

属性

DisplayName

只读属性，用于获取包含此文件的显示名称的字符串。

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

Editor

只读属性，可获取用于指定文件的编辑器。 

# Gets the editor and the text.
$myfile=$psIse.CurrentFile
$myfile.Editor.Text

Encoding

只读属性，用于获取原始文件编码。该属性为 System.Text.Encoding 对象。

# Shows the encoding for the file. 
$myfile=$psIse.CurrentFile
$myfile.Encoding

FullPath

只读属性，可获取用于指定已打开文件的完整路径的字符串。

# Shows the full path for the file. 
$myfile=$psIse.CurrentFile
$myfile.FullPath

IsSaved

只读的布尔型属性，如果文件自上次修改后已经保存，此属性将返回 true。

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

IsUntitled

只读属性，如果文件从未获得标题，此属性为 true。

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

另请参阅



目录