• Article

FILEPROPERTY (Transact-SQL)

Retourne la valeur de la propriété du nom de fichier spécifié lorsqu'un nom de fichier présent dans la base de données actuelle et un nom de propriété sont fournis. Retourne NULL pour les fichiers qui ne se trouvent pas dans la base de données active.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

FILEPROPERTY (file_name ,property )

Argument

  • file_name
    Expression composée du nom du fichier associé à celui de la base de données actuelle dont les informations de propriété doivent être retournées. file_name est de type nchar(128).

  • property
    Expression qui contient le nom de la propriété de fichier à retourner. property est de type varchar(128) et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    Valeur retournée

    IsReadOnly

    Groupe de fichiers en lecture seule.

    1 = Vrai

    0 = Faux

    NULL = Entrée non valide.

    IsPrimaryFile

    Le fichier est le fichier principal.

    1 = Vrai

    0 = Faux

    NULL = Entrée non valide.

    IsLogFile

    Le fichier est un fichier journal.

    1 = Vrai

    0 = Faux

    NULL = Entrée non valide.

    SpaceUsed

    Quantité d'espace occupé par le fichier spécifié.

    Nombre de pages allouées dans le fichier.

Types de retour

int

Notes

file_name correspond à la colonne name de l'affichage catalogue sys.master_files ou sys.database_files.

Exemple

Cet exemple retourne la valeur de la propriété IsPrimaryFile pour le nom du fichier AdventureWorks2008R2_Data dans la base de données AdventureWorks2008R2.

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

Voici l'ensemble des résultats.

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