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

Methoden

Save(System.Text.Encoding saveEncoding)

Speichert die Datei auf dem Datenträger.

saveEncoding
Die für die gespeicherte Datei zu verwendende Codierung.

Ausnahmen
  • System.IO.IOException: Die Datei konnte nicht gespeichert werden. 

# Save the file as ASCII.
$myfile=$psIse.CurrentFile
$myfile.Save( [System.Text.Encoding]::ASCII)

# Gets the current encoding.
$myfile=$psIse.CurrentFile
$myfile.Encoding

Save()

Speichert die Datei.

Ausnahmen
  • System.IO.IOException: Die Datei konnte nicht gespeichert werden.

# Explicitly save the file. 
$psIse.CurrentFile.save()

SaveAs(string fileName)

Speichert die Datei unter dem angegebenen fileName.

fileName
Der Name, unter dem die Datei gespeichert werden soll. Die Standardcodierung für die Methode ist UTF-16.

Ausnahmen
  • System.ArgumentNullException: Der fileName ist NULL.

  • System.ArgumentException: Der fileName ist leer.

  • System.IO.IOException: Die Datei konnte nicht gespeichert werden.

# Explicitly save the file. 
$fullpath = "c:\temp\newname.txt"
$myfile=$psIse.CurrentFile
$myfile.SaveAs($fullPath)

SaveAs(string fileName, System.Text.Encoding saveEncoding)

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

fileName:
Der Name, unter dem die Datei gespeichert werden soll. Sie können den vollständigen Pfadnamen für die Datei angeben.

saveEncoding
Die Codierung, mit der die Datei gespeichert werden soll.

Ausnahmen
  • System.ArgumentNullException: Der fileName ist NULL.

  • System.ArgumentException: Der fileName ist leer.

  • System.IO.IOException: Die Datei konnte nicht gespeichert werden.

# Explicitly save the file as UTF8.
$fullpath = "c:\temp\newname.txt"
$myfile=$psIse.CurrentFile
$myfile.SaveAs($fullPath, [System.Text.Encoding]::UTF8)
# Gets the current encoding.
$myfile=$psIse.CurrentFile
$myfile.Encoding

Eigenschaften

DisplayName

Schreibgeschützte Eigenschaft, mit der die Zeichenfolge abgerufen wird, die den Anzeigenamen dieser Datei enthält.

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

Editor

Schreibgeschützte Eigenschaft, die den Editor abruft, der für die angegebene Datei verwendet wird. 

# Gets the editor and the text.
$myfile=$psIse.CurrentFile
$myfile.Editor.Text

Encoding

Schreibgeschützte Eigenschaft, mit der die ursprüngliche Dateicodierung abgerufen wird. Dies ist ein System.Text.Encoding-Objekt.

# Shows the encoding for the file. 
$myfile=$psIse.CurrentFile
$myfile.Encoding

FullPath

Schreibgeschützte Eigenschaft, mit der die Zeichenfolge abgerufen wird, die den vollständigen Pfad der geöffneten Datei angibt.

# Shows the full path for the file. 
$myfile=$psIse.CurrentFile
$myfile.FullPath

IsSaved

Schreibgeschützte boolesche Eigenschaft, die "True" zurückgibt, wenn die Datei seit der letzten Änderung gespeichert wurde.

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

IsUntitled

Schreibgeschützte Eigenschaft, die den Wert "True" hat, wenn der Datei nie ein Titel zugewiesen wurde.

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

Siehe auch



Inhaltsverzeichnis