El objeto ISEFile

  • Artículo

Un objeto ISEFile representa un archivo en el Entorno de scripting integrado (ISE) de Windows PowerShell. Es una instancia de la clase Microsoft.PowerShell.Host.ISE.ISEFile. Este tema enumera sus métodos de miembro y propiedades de miembro. $psISE.CurrentFile y los archivos de la colección de archivos en una pestaña de PowerShell son instancias de la clase **Microsoft.PowerShell.Host.ISE.ISEFile.

Métodos

Save( [codificaciónDeGuardado] )

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

Guarda el archivo en disco.

[saveEncoding]: System.Text.Encoding opcional. Un parámetro de codificación de carácter opcional que se usará para el archivo guardado. El valor predeterminado es UTF8.

Excepciones

  • System.IO.IOException: no se pudo guardar el archivo.
# 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(nombreDeArchivo, [codificaciónDeGuardado])

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

Guarda el archivo con el nombre de archivo y codificación especificados.

filename: cadena. El nombre que se utilizará para guardar el archivo.

[saveEncoding]: System.Text.Encoding opcional. Un parámetro de codificación de carácter opcional que se usará para el archivo guardado. El valor predeterminado es UTF8.

Excepciones

  • System.ArgumentNullException: el parámetro nombre_de_archivo es null.
  • System.ArgumentException: el parámetro nombre_de_archivo está vacío.
  • System.IO.IOException: no se pudo guardar el archivo.
# 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)

Propiedades

Nombre para mostrar

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

La propiedad de solo lectura que obtiene la cadena que contiene el nombre para mostrar de este archivo. El nombre se muestra en la pestaña Archivo en la parte superior del editor. La presencia de un asterisco (*) al final del nombre indica que el archivo tiene cambios que no se han guardado.

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

Editor

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

La propiedad de solo lectura que obtiene el objeto de editor que se utiliza para el archivo especificado.

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

Encoding

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

La propiedad de solo lectura que obtiene la codificación del archivo original. Se trata de un objeto System.Text.Encoding.

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

FullPath

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

La propiedad de solo lectura que obtiene la cadena que especifica la ruta de acceso completa del archivo abierto.

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

IsSaved

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

La propiedad booleana de solo lectura que devuelve $true si el archivo se ha guardado una vez que se modificó por última vez.

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

IsUntitled

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.

La propiedad de solo lectura que devuelve $true si nunca se asignó un título al archivo.

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

Consulte también