FILEPROPERTY (Transact-SQL)FILEPROPERTY (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Gibt den Eigenschaftswert für den angegebenen Dateinamen zurück, wenn ein Dateiname in der aktuellen Datenbank und ein Eigenschaftsname angegeben sind.Returns the specified file name property value when a file name in the current database and a property name are specified. Gibt NULL für Dateien zurück, die nicht in der aktuellen Datenbank sind.Returns NULL for files that are not in the current database.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


FILEPROPERTY ( file_name , property )  

ArgumenteArguments

file_namefile_name
Ein Ausdruck, der den Namen der Datei enthält, die der aktuellen Datenbank zugeordnet ist, für die Eigenschaftsinformationen zurückgegeben werden sollen.Is an expression that contains the name of the file associated with the current database for which to return property information. file_name ist vom Datentyp nchar(128).file_name is nchar(128).

propertyproperty
Ein Ausdruck, der den Namen der zurückzugebenden Dateieigenschaft enthält.Is an expression that contains the name of the file property to return. property ist vom Datentyp varchar(128). Die folgenden Werte sind möglich.property is varchar(128), and can be one of the following values.

valueValue und BeschreibungDescription Zurückgegebener WertValue returned
IsReadOnlyIsReadOnly Dateigruppe ist schreibgeschützt.Filegroup is read-only. 1 = True1 = True

0 = False0 = False

NULL = Eingabe ist nicht gültig.NULL = Input is not valid.
IsPrimaryFileIsPrimaryFile Datei ist die primäre Datei.File is the primary file. 1 = True1 = True

0 = False0 = False

NULL = Eingabe ist nicht gültig.NULL = Input is not valid.
IsLogFileIsLogFile Datei ist eine Protokolldatei.File is a log file. 1 = True1 = True

0 = False0 = False

NULL = Eingabe ist nicht gültig.NULL = Input is not valid.
SpaceUsedSpaceUsed Speicherplatz, der von der angegebenen Datei verwendet wird.Amount of space that is used by the specified file. Anzahl der in der Datei zugeordneten Seiten.Number of pages allocated in the file

RückgabetypenReturn Types

intint

RemarksRemarks

file_name entspricht der name-Spalte in den Katalogsichten sys.master_files oder sys.database_files.file_name corresponds to the name column in the sys.master_files or sys.database_files catalog view.

BeispieleExamples

Im folgenden Beispiel wird die Einstellung für die IsPrimaryFile-Eigenschaft des AdventureWorks_Data-Dateinamens in der AdventureWorks2012AdventureWorks2012-Datenbank zurückgegeben.The following example returns the setting for the IsPrimaryFile property for the AdventureWorks_Data file name in AdventureWorks2012AdventureWorks2012 the database.


SELECT FILEPROPERTY('AdventureWorks2012_Data', 'IsPrimaryFile')AS [Primary File];  
GO  

Im Folgenden finden Sie das Resultset.Here is the result set.

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

Weitere Informationen finden Sie unterSee Also

FILEGROUPPROPERTY (Transact-SQL) FILEGROUPPROPERTY (Transact-SQL)
Metadata Functions (Transact-SQL) (Metadatenfunktionen (Transact-SQL)) Metadata Functions (Transact-SQL)
sp_spaceused (Transact-SQL) sp_spaceused (Transact-SQL)
sys.database_files (Transact-SQL) sys.database_files (Transact-SQL)
sys.master_files (Transact-SQL)sys.master_files (Transact-SQL)