FILEPROPERTY (Transact-SQL)

指定目前資料庫中的檔案名稱和屬性名稱時,傳回指定的檔案名稱屬性值。針對不在目前資料庫中的檔案,傳回 NULL。

主題連結圖示Transact-SQL 語法慣例

語法

FILEPROPERTY (file_name ,property )

引數

  • file_name
    這是包含傳回屬性資訊所屬的目前資料庫之相關聯檔案名稱的運算式。file_name 是 nchar(128)。

  • property
    這是包含要傳回之檔案屬性名稱的運算式。property 是 varchar(128),它可以是下列值之一。

    描述

    傳回的值

    IsReadOnly

    檔案群組是唯讀的。

    1 = True

    0 = False

    NULL = 輸入無效。

    IsPrimaryFile

    檔案是主要檔案。

    1 = True

    0 = False

    NULL = 輸入無效。

    IsLogFile

    檔案是記錄檔。

    1 = True

    0 = False

    NULL = 輸入無效。

    SpaceUsed

    指定檔案所用的空間量。

    檔案中所配置的頁數

傳回類型

int

備註

file_name 對應於 sys.master_filessys.database_files 目錄檢視中的 name 資料行。

範例

下列範例會傳回 AdventureWorks2008R2 資料庫中 AdventureWorks2008R2_Data 檔案名稱的 IsPrimaryFile 屬性設定。

USE AdventureWorks2008R2;
GO
SELECT FILEPROPERTY('AdventureWorks2008R2_Data', 'IsPrimaryFile')AS [Primary File];
GO

以下為結果集:

Primary File 
-------------
1
(1 row(s) affected)