ISEFileCollection 对象The ISEFileCollection Object

本文内容

ISEFileCollection 对象是 ISEFile 对象的集合。例如,$psISE.CurrentPowerShellTab.Files 集合。

方法Methods

Add( [fullPath] )Add( [fullPath] )

在 Windows PowerShell ISE 2.0 和更高版本中受支持。

创建并返回一个新的未命名文件,并将其添加到集合中。新创建的文件的 IsUntitled 属性为 $true

[fullPath] - 可选字符串,表示文件的完全指定路径。如果包含 fullPath 参数和相对路径,或者如果你使用文件名而不是完整路径,则会生成异常。

  1. # Adds a new untitled file to the collection of files in the current PowerShell tab.
  2. $newFile = $psISE.CurrentPowerShellTab.Files.Add()
  3. # Adds a file specified by its full path to the collection of files in the current PowerShell tab.
  4. $psISE.CurrentPowerShellTab.Files.Add("$pshome\Examples\profile.ps1")

Remove( File, [Force] )Remove( File, [Force] )

在 Windows PowerShell ISE 2.0 和更高版本中受支持。

从当前 PowerShell 选项卡中删除指定的文件。

File - 字符串,表示要从集合中删除的 ISEFile 文件。如果尚未保存该文件,此方法将引发异常。使用 Force 开关参数强制删除未保存的文件。

[Force] - 可选布尔值,如果设置为 $true,即使在最后一次使用后尚未保存文件,也会授予权限来删除该文件。默认值为 $false

  1. # Removes the first opened file from the file collection associated with the current PowerShell tab.
  2. # If the file has not yet been saved, then an exception is generated.
  3. $firstfile = $psISE.CurrentPowerShellTab.Files[0]
  4. $psISE.CurrentPowerShellTab.Files.Remove($firstfile)
  5. # Removes the first opened file from the file collection associated with the current PowerShell tab, even if it has not been saved.
  6. $firstfile = $psISE.CurrentPowerShellTab.Files[0]
  7. $psISE.CurrentPowerShellTab.Files.Remove($firstfile, $true)

SetSelectedFile( selectedFile )SetSelectedFile( selectedFile )

在 Windows PowerShell ISE 2.0 和更高版本中受支持。

选择由 selectedFile 参数指定的文件。

selectedFile - Microsoft.PowerShell.Host.ISE.ISEFile,要选择的 ISEFile 文件。

  1. # Selects the specified file.
  2. $firstfile = $psISE.CurrentPowerShellTab.Files[0]
  3. $psISE.CurrentPowerShellTab.Files.SetSelectedFile($firstfile)

另请参阅See Also