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

Gilt für: JaSQL Server NeinAzure SQL-Datenbank NeinAzure Synapse Analytics (SQL DW) NeinParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) 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.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic 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 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

BemerkungenRemarks

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  

Hier ist das Resultset.Here is the result set.

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

Weitere InformationenSee 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)