SetAttr 函式

更新：2007 年 11 月

設定檔案的屬性 (Attribute) 資訊。

My 功能在檔案 I/O 作業中的產能和效能勝過 SetAttr。如需詳細資訊，請參閱 My.Computer.FileSystem 物件。

Public Sub SetAttr( _
    ByVal PathName As String, _
    ByVal Attributes As FileAttribute _
)

參數

• PathName
  必要項。指定檔案名稱的 String 運算式。PathName 可以包含目錄或資料夾，以及磁碟。

• Attributes
  必要項。常數或數值運算式，其總和可以表示檔案屬性。

設定

Attributes 引數列舉值為：

值	常數	描述
Normal	vbNormal	一般 (預設值)。
ReadOnly	vbReadOnly	唯讀。
Hidden	vbHidden	隱藏。
System	vbSystem	系統檔案。
Volume	vbVolume	磁碟區標籤
Directory	vbDirectory	目錄或資料夾。
Archive	vbArchive	檔案自上次備份後已經過修改。
Alias	vbAlias	檔案具有不同的名稱。

注意事項：
這些列舉型別是由 Visual Basic 語言所指定。您可在程式碼中的任何地方使用這些名稱來取代實際值。

例外狀況

例外狀況類型	錯誤代碼	條件
ArgumentException	52	PathName 無效或是不存在。
ArgumentException	5	Attribute 型別無效。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

如果您嘗試設定開啟的檔案的屬性，則會發生執行階段錯誤。

範例

這個範例會使用 SetAttr 函式來設定檔案的屬性。

' Set hidden attribute.
SetAttr("TESTFILE", vbHidden)   
' Set hidden and read-only attributes.
SetAttr("TESTFILE", vbHidden Or vbReadOnly)

智慧型裝置開發人員注意事項

不支援這個函式。

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

**模組︰**FileSystem

組件：Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

FileAttr 函式

GetAttr 函式

ArgumentException

FileAttribute 列舉型別

My.Computer.FileSystem 物件