Partilhar via

O Objeto ISEFile

Um objeto ISEFile representa um ficheiro no Ambiente Integrado de Scripting (ISE) do Windows PowerShell. É uma instância da classe Microsoft.PowerShell.Host.ISE.ISEFile . Este tópico lista os seus métodos e propriedades membros. Os $psISE.CurrentFile ficheiros e na coleção Ficheiros num separador PowerShell são todos instâncias da classe Microsoft.PowerShell.Host.ISE.ISEFile .

Methods

Save( [saveEncoding] )

Suportado no Windows PowerShell ISE 2.0 e posteriores.

Guarda o ficheiro no disco.

[saveEncoding] - opcional System.Text.Encoding Um parâmetro opcional de codificação de caracteres a ser usado para o ficheiro guardado. O valor padrão é UTF8.

Exceptions

  • System.IO.IOException: O ficheiro não pôde ser guardado.
# 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(nome do ficheiro, [saveEncoding])

Suportado no Windows PowerShell ISE 2.0 e posteriores.

Guarda o ficheiro com o nome e a codificação especificados.

nome do ficheiro - String O nome a usar para guardar o ficheiro.

[saveEncoding] - opcional System.Text.Encoding Um parâmetro opcional de codificação de caracteres a ser usado para o ficheiro guardado. O valor padrão é UTF8.

Exceptions

  • System.ArgumentNullException: O parâmetro do nome do ficheiro é nulo.
  • System.ArgumentException: O parâmetro do nome do ficheiro está vazio.
  • System.IO.IOException: O ficheiro não pôde ser guardado.
# 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

Nome de Exibição

Suportado no Windows PowerShell ISE 2.0 e posteriores.

A propriedade de apenas leitura que recebe a cadeia que contém o nome de exibição deste ficheiro. O nome é mostrado no separador Ficheiro no topo do editor. A presença de um asterisco (*) no final do nome indica que o ficheiro tem alterações que não foram guardadas.

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

Editor

Suportado no Windows PowerShell ISE 2.0 e posteriores.

A propriedade de só leitura que recebe o objeto editor usado para o ficheiro especificado.

# Gets the editor and the text.
$psISE.CurrentFile.Editor.Text

Codificação

Suportado no Windows PowerShell ISE 2.0 e posteriores.

A propriedade de apenas leitura que recebe a codificação original do ficheiro. Isto é um objeto System.Text.Encoding .

# Shows the encoding for the file.
$psISE.CurrentFile.Encoding

Caminho completo

Suportado no Windows PowerShell ISE 2.0 e posteriores.

A propriedade de apenas leitura que recebe a cadeia que especifica o caminho completo do ficheiro aberto.

# Shows the full path for the file.
$psISE.CurrentFile.FullPath

IsSaved

Suportado no Windows PowerShell ISE 2.0 e posteriores.

A propriedade Booleana de apenas leitura que retorna $true se o ficheiro tiver sido guardado após a última modificação.

# 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 de apenas leitura que retorna $true se o ficheiro 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

Ver também

  • Last updated on