Share via


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 物件