O objeto ISEFile
Um objeto ISEFile representa um arquivo no ISE (Ambiente de Script Integrado) do Windows PowerShell. É uma instância da classe Microsoft.PowerShell.Host.ISE.ISEFile. Este tópico lista os métodos e as propriedades do membro. O $psISE.CurrentFile e os arquivos da coleção de arquivos em uma guia do PowerShell são instâncias da classe **Microsoft.PowerShell.Host.ISE.ISEFile.
Métodos
Save( [saveEncoding] )
Suportado no Windows PowerShell ISE 2.0 e posteriores.
Salva o arquivo no disco.
[saveEncoding] – System.Text.Encoding opcional Um parâmetro de codificação de caracteres opcional a ser usado no arquivo salvo. O valor padrão é UTF8.
Exceções
- System.IO.IOException: não foi possível salvar o arquivo.
# 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])
Suportado no Windows PowerShell ISE 2.0 e posteriores.
Salva o arquivo com o nome de arquivo e codificação especificados.
filename – cadeia de caracteres, o nome a ser usado para salvar o arquivo.
[saveEncoding] – System.Text.Encoding opcional Um parâmetro de codificação de caracteres opcional a ser usado no arquivo salvo. O valor padrão é UTF8.
Exceções
- System.ArgumentNullException: o parâmetro filename é nulo.
- System.ArgumentException: o parâmetro filename está vazio.
- System.IO.IOException: não foi possível salvar o arquivo.
# 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)
Propriedades
DisplayName
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade somente leitura que obtém a cadeia que contém o nome de exibição deste arquivo. O nome é mostrado na guia Arquivo na parte superior do editor. A presença de um asterisco (*) ao final do nome indica que o arquivo tem alterações que não foram salvas.
# Shows the display name of the file.
$psISE.CurrentFile.DisplayName
Editor
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade somente leitura que obtém o objeto editor usado para o arquivo especificado.
# Gets the editor and the text.
$psISE.CurrentFile.Editor.Text
Codificação
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade somente leitura que obtém a codificação original do arquivo. Este é um objeto System.Text.Encoding.
# Shows the encoding for the file.
$psISE.CurrentFile.Encoding
FullPath
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade somente leitura que obtém a cadeia de caracteres que especifica o caminho completo do arquivo aberto.
# Shows the full path for the file.
$psISE.CurrentFile.FullPath
IsSaved
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade booliana somente leitura que retornará $true se o arquivo tiver sido salvo depois de ter sido modificado pela última vez.
# Determines whether the file has been saved since it was last modified.
$myfile = $psISE.CurrentFile
$myfile.IsSaved
IsUntitled
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade somente leitura que retornará $true se o arquivo nunca tiver recebido um título.
# Determines whether the file has never been given a title.
$psISE.CurrentFile.IsUntitled
$psISE.CurrentFile.SaveAs("temp.txt")
$psISE.CurrentFile.IsUntitled
