ISEFile オブジェクトは、Windows PowerShell Integrated Scripting Environment (ISE) 内のファイルを表します。これは、Microsoft.PowerShell.Host.ISE.ISEFile クラスのインスタンスです。ここでは、そのメンバー メソッドとメンバー プロパティを紹介しています。Powershell タブの Files コレクション内のファイルおよび $psISE.CurrentFile は、Microsoft.PowerShell.Host.ISE.ISEFile クラスのインスタンスです。

メソッド

Save(System.Text.Encoding saveEncoding)

ファイルをディスクに保存します。

saveEncoding
保存したファイルに使用するエンコード。

例外
  • System.IO.IOException: ファイルを保存できませんでした。

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

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

Save()

ファイルを保存します。

例外
  • System.IO.IOException: ファイルを保存できませんでした。

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

SaveAs(string fileName)

指定されたファイル名でファイルを保存します。

fileName
保存するファイルに付ける名前。このメソッドの既定のエンコードは UTF-16 です。

例外
  • System.ArgumentNullException: fileName が null です。

  • System.ArgumentException: fileName が空です。

  • System.IO.IOException: ファイルを保存できませんでした。

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

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

ファイル名とエンコードを指定してファイルを保存します。

fileName:
保存するファイルに付ける名前。ファイルの完全パス名を指定できます。

saveEncoding
ファイルを保存するときに使用するエンコード。

例外
  • System.ArgumentNullException: fileName が null です。

  • System.ArgumentException: fileName が空です。

  • System.IO.IOException: ファイルを保存できませんでした。

# 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

プロパティ

DisplayName

このファイルの表示名を保持する文字列を取得するための読み取り専用プロパティ。

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

Editor

指定されたファイル用のエディターを取得するための読み取り専用プロパティ。

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

Encoding

元のファイルのエンコードを取得する読み取り専用プロパティ。これは System.Text.Encoding オブジェクトです。

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

FullPath

開いたファイルの完全パスを指定する文字列を取得するための読み取り専用プロパティ。

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

IsSaved

ファイルが前回修正時から保存されている場合に true を返す、読み取り専用のブール型プロパティ。

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

IsUntitled

ファイルにタイトルが指定されていない場合に true になる読み取り専用プロパティ。

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

関連項目




目次