Das ISEFile-Objekt

Ein ISEFile-Objekt stellt eine Datei in der Windows PowerShell Integrated Scripting Environment (ISE) dar. Es handelt sich um eine Instanz der Klasse Microsoft.PowerShell.Host.ISE.ISEFile . Dieses Thema listet seine Mitgliedsmethoden und Mitgliedereigenschaften auf. Die $psISE.CurrentFile und die Dateien in der Dateisammlung in einem PowerShell-Tab sind alle Instanzen der Klasse Microsoft.PowerShell.Host.ISE.ISEFile .

Methodik

Speichern( [saveEncoding] )

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Speichert die Datei auf der Festplatte.

[saveEncoding] - optionale System.Text.Encoding Ein optionaler Zeichenkodierungsparameter, der für die gespeicherte Datei verwendet wird. Der Standardwert ist UTF8.

Exceptions

  • System.IO.IOException: Die Datei konnte nicht gespeichert werden.
# 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(Dateiname, [saveEncoding])

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Speichert die Datei mit dem angegebenen Dateinamen und der Kodierung.

Dateiname - String Der Name, der zum Speichern der Datei verwendet werden soll.

[saveEncoding] - optionale System.Text.Encoding Ein optionaler Zeichenkodierungsparameter, der für die gespeicherte Datei verwendet wird. Der Standardwert ist UTF8.

Exceptions

  • System.ArgumentNullException: Der Dateinameparameter ist null.
  • System.ArgumentException: Der Dateinameparameter ist leer.
  • System.IO.IOException: Die Datei konnte nicht gespeichert werden.
# 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)

Eigenschaften

Anzeigename

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Die Schreib-nur-Eigenschaft, die den String abruft, der den Anzeigenamen dieser Datei enthält. Der Name wird im Datei-Tab oben im Editor angezeigt. Das Vorhandensein eines Sternchens (*) am Ende des Namens zeigt an, dass die Datei Änderungen enthält, die nicht gespeichert wurden.

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

Editor

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Die Read-only-Eigenschaft, die das Editor-Objekt abruft, das für die angegebene Datei verwendet wird.

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

Codierung

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Die schreibgeschützte Eigenschaft, die die ursprüngliche Dateikodierung ermöglicht. Dies ist ein System.Text.Encoding-Objekt .

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

FullPath

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Die schreibgeschützte Eigenschaft, die die Zeichenkette abruft, die den vollständigen Pfad der geöffneten Datei angibt.

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

IsSaved

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Die schreibgeschützte boolesche Eigenschaft, die zurückgegeben $true wird, wenn die Datei nach ihrer letzten Änderung gespeichert wurde.

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

IsUntitled

Unterstützt in Windows PowerShell ISE 2.0 und neuer.

Die schreibgeschützte Eigenschaft, die zurückkehrt $true , wenn die Datei nie einen Titel erhalten hat.

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

Siehe auch

  • Last updated on