Compartilhar via


O objeto ISEFileCollection

O objeto ISEFileCollection é uma coleção de objetos ISEFile. Um exemplo é a coleção $psISE.CurrentPowerShellTab.Files.

Métodos

Add( [FullPath] )

Suportado no Windows PowerShell ISE 2.0 e posteriores.

Cria e retorna um novo arquivo sem título e o adiciona à coleção. A propriedade IsUntitled do arquivo recém-criado é $true.

[FullPath] – cadeia de caracteres opcional; o caminho totalmente especificado do arquivo. Uma exceção será gerada se você incluir o parâmetro FullPath e um caminho relativo ou se você usar um nome de arquivo em vez do caminho completo.

# Adds a new untitled file to the collection of files in the current PowerShell tab.
$newFile = $psISE.CurrentPowerShellTab.Files.Add()

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

Remove( File, [Force] )

Suportado no Windows PowerShell ISE 2.0 e posteriores.

Remove um arquivo especificado da guia atual do PowerShell.

File – cadeia de caracteres, o arquivo ISEFile que você deseja remover da coleção. Se o arquivo não tiver sido salvo, esse método disparará uma exceção. Use o parâmetro de comutador Force para forçar a remoção de um arquivo que não foi salvo.

[Force] – booliano opcional; se definido como $true, concederá permissão para remover o arquivo mesmo se ele não tiver sido salvo após o último uso. O padrão é $false.

# Removes the first opened file from the file collection associated with the current PowerShell tab.
# If the file has not yet been saved, then an exception is generated.
$firstfile = $psISE.CurrentPowerShellTab.Files[0]
$psISE.CurrentPowerShellTab.Files.Remove($firstfile)

# Removes the first opened file from the file collection associated with the current PowerShell tab, even if it has not been saved.
$firstfile = $psISE.CurrentPowerShellTab.Files[0]
$psISE.CurrentPowerShellTab.Files.Remove($firstfile, $true)

SetSelectedFile( selectedFile )

Suportado no Windows PowerShell ISE 2.0 e posteriores.

Escolhe o arquivo especificado pelo parâmetro SelectedFile.

SelectedFile – Microsoft.PowerShell.Host.ISE.ISEFile, o arquivo ISEFile que você quer escolher.

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

Consulte Também