Partager via


Objet ISEFile

Un objet ISEFile représente un fichier dans l’environnement de script intégré Windows PowerShell (ISE). Il s’agit d’une instance de la classe Microsoft.PowerShell.Host.ISE.ISEFile. Cette rubrique répertorie ses méthodes membres et ses propriétés de membre. Les $psISE.CurrentFile et les fichiers de la collection Files dans un onglet PowerShell sont toutes les instances de la classe **Microsoft.PowerShell.Host.ISE.ISEFile.

Méthode

Save( [saveEncoding] )

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Enregistre le fichier sur le disque.

[saveEncoding] - facultatif System.Text.Encoding Paramètre d’encodage de caractères facultatif à utiliser pour le fichier enregistré. La valeur par défaut est UTF8 .

Exceptions

  • System.IO.IOException: impossible d’enregistrer le fichier.
# 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])

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Enregistre le fichier avec le nom et l’encodage de fichier spécifiés.

nom de fichier - Chaîne Le nom à utiliser pour enregistrer le fichier.

[saveEncoding] - facultatif System.Text.Encoding Paramètre d’encodage de caractères facultatif à utiliser pour le fichier enregistré. La valeur par défaut est UTF8 .

Exceptions

  • System.ArgumentNullException: le paramètre nom de fichier est null.
  • system.ArgumentException: le paramètre nom de fichier est vide.
  • System.IO.IOException: impossible d’enregistrer le fichier.
# 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)

Propriétés

DisplayName

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Propriété en lecture seule qui obtient la chaîne qui contient le nom complet de ce fichier. Le nom s’affiche sous l’onglet Fichier en haut de l’éditeur. La présence d’un astérisque (*) à la fin du nom indique que le fichier a des modifications qui n’ont pas été enregistrées.

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

Éditeur

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Propriété en lecture seule qui obtient l’objet éditeur utilisé pour le fichier spécifié.

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

Codage

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Propriété en lecture seule qui obtient l’encodage de fichier d’origine. Il s’agit d’un objet System.Text.Encoding.

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

FullPath

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Propriété en lecture seule qui obtient la chaîne qui spécifie le chemin d’accès complet du fichier ouvert.

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

IsSaved

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Propriété booléenne en lecture seule qui retourne $true si le fichier a été enregistré après sa dernière modification.

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

IsUntitled

Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.

Propriété en lecture seule qui retourne $true si le fichier n’a jamais reçu de titre.

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

Voir aussi