共用方式為


ISEFile 物件

ISEFile 物件代表 Windows PowerShell 整合式腳本環境 (ISE) 中的檔案。 它是 Microsoft.PowerShell.Host.ISE.ISEFile 類別的實例。 本主題列出其成員方法和成員屬性。 PowerShell $psISE.CurrentFile 索引標籤中 Files 集合中的 和 檔案都是 **Microsoft.PowerShell.Host.ISE.ISEFile 類別的所有實例。

方法

Save( [saveEncoding] )

Windows PowerShell ISE 2.0 和更新版本支援。

將檔案儲存至磁碟。

[saveEncoding] - 選擇性 System.Text.Encoding 要用於儲存盤案的選擇性字元編碼參數。 預設值為 UTF8

例外狀況

  • System.IO.IOException:無法儲存盤案。
# 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])

Windows PowerShell ISE 2.0 和更新版本支援。

以指定的檔名和編碼方式儲存盤案。

filename - 字串 要用來儲存盤案的名稱。

[saveEncoding] - 選擇性 System.Text.Encoding 要用於儲存盤案的選擇性字元編碼參數。 預設值為 UTF8

例外狀況

  • System.ArgumentNullExceptionfilename 參數為 null。
  • System.ArgumentException:filename 參數是空的
  • System.IO.IOException:無法儲存盤案。
# 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)

屬性

DisplayName

Windows PowerShell ISE 2.0 和更新版本支援。

唯讀屬性,可取得包含此檔案顯示名稱的字串。 名稱會顯示在 編輯器頂端的 [檔案 ] 索引標籤上。 名稱結尾處有星號 (*) ,表示檔案有尚未儲存的變更。

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

編輯器

Windows PowerShell ISE 2.0 和更新版本支援。

唯讀屬性,可取得 用於指定檔案的編輯器物件

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

編碼方式

Windows PowerShell ISE 2.0 和更新版本支援。

取得源檔編碼的唯讀屬性。 這是 System.Text.Encoding 物件。

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

FullPath

Windows PowerShell ISE 2.0 和更新版本支援。

唯讀屬性,可取得指定開啟檔案完整路徑的字串。

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

IsSaved

Windows PowerShell ISE 2.0 和更新版本支援。

只讀的 Boolean 屬性,如果檔案在上次修改之後已儲存,則會傳回 $true 該屬性。

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

IsUntitled

Windows PowerShell ISE 2.0 和更新版本支援。

如果檔案從未獲得標題,則傳回 $true 的唯讀屬性。

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

另請參閱