Freigeben über

Das ISEFile-Objekt

  • Artikel

Ein ISEFile-Objekt stellt eine Datei in Windows-PowerShell Integrated Scripting Environment (ISE) dar. Es handelt sich um eine Instanz der Microsoft.PowerShell.Host.ISE.ISEFile-Klasse. In diesem Thema werden die Elementmethoden und -eigenschaften aufgeführt. $psISE.CurrentFile und die Dateien in der Dateisammlung auf einer PowerShell-Registerkarte sind Instanzen der **Microsoft.PowerShell.Host.ISE.ISEFile-Klasse.

Methoden

Save( [saveEncoding] )

In Windows PowerShell ISE 2.0 und höher unterstützt.

Speichert die Datei auf dem Datenträger.

[saveEncoding]: optional System.Text.Encoding Ein optionaler Zeichencodierungsparameter, der für die gespeicherte Datei verwendet werden soll. Der Standardwert lautet UTF8.

Ausnahmen

  • 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(filename, [saveEncoding])

In Windows PowerShell ISE 2.0 und höher unterstützt.

Speichert die Datei mit dem angegebenen Namen und der angegebenen Codierung.

Dateiname: Zeichenfolge – der Name, der zum Speichern der Datei verwendet werden soll.

[saveEncoding]: optional System.Text.Encoding Ein optionaler Zeichencodierungsparameter, der für die gespeicherte Datei verwendet werden soll. Der Standardwert lautet UTF8.

Ausnahmen

  • System.ArgumentNullException: Der filename-Parameter ist NULL.
  • System.ArgumentException: Der filename-Parameter 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

DisplayName

In Windows PowerShell ISE 2.0 und höher unterstützt.

Die schreibgeschützte Eigenschaft, die die Zeichenfolge mit dem Anzeigenamen dieser Datei abruft. Der Name wird auf der Registerkarte Datei oben im Editor angezeigt. Ein Sternchen (*) am Ende des Namens zeigt an, dass die Datei nicht gespeicherte Änderungen enthält.

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

Editor

In Windows PowerShell ISE 2.0 und höher unterstützt.

Die schreibgeschützte Eigenschaft, die das für die angegebene Datei verwendete Editor-Objekt abruft.

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

Codieren

In Windows PowerShell ISE 2.0 und höher unterstützt.

Die schreibgeschützte Eigenschaft, die die ursprüngliche Dateicodierung abruft. Dies ist ein System.Text.Encoding-Objekt.

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

FullPath

In Windows PowerShell ISE 2.0 und höher unterstützt.

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

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

IsSaved

In Windows PowerShell ISE 2.0 und höher unterstützt.

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

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

IsUntitled

In Windows PowerShell ISE 2.0 und höher unterstützt.

Die schreibgeschützte Eigenschaft, die $true zurückgibt, wenn für die Datei nie ein Titel festgelegt wurde.

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

Weitere Informationen