Objet ISEFile

  • Article

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

Méthodes

Save( [saveEncoding] )

Prise 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 facultatif d’encodage de caractères à utiliser pour le fichier enregistré. La valeur par défaut est UTF8.

Exceptions

  • System.IO.IOException : le fichier n’a pas pu être enregistré.
# 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])

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

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

filename : chaîne Nom à utiliser pour enregistrer le fichier.

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

Exceptions

  • System.ArgumentNullException : le paramètre filename est Null.
  • System.ArgumentException : le paramètre filename est vide.
  • System.IO.IOException : le fichier n’a pas pu être enregistré.
# 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

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

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

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

Éditeur

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

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

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

Encodage

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

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

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

FullPath

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

Propriété en lecture seule qui obtient la chaîne spécifiant le chemin complet du fichier ouvert.

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

IsSaved

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

Propriété booléenne en lecture seule qui renvoie la valeur $true si le fichier a été enregistré depuis sa dernière modification.

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

IsUntitled

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

Propriété en lecture seule qui renvoie la valeur $true si le fichier n’a pas encore 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