Freigeben über


FILEPROPERTY (Transact-SQL)

Gibt den Eigenschaftswert für den angegebenen Dateinamen zurück, wenn ein Dateiname in der aktuellen Datenbank und ein Eigenschaftsname angegeben sind. Gibt NULL für Dateien zurück, die nicht in der aktuellen Datenbank sind.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

FILEPROPERTY ( file_name , property )

Argumente

  • file_name
    Ein Ausdruck, der den Namen der Datei enthält, die der aktuellen Datenbank zugeordnet ist, für die Eigenschaftsinformationen zurückgegeben werden sollen. file_name ist vom Datentyp nchar(128).

  • property
    Ein Ausdruck, der den Namen der zurückzugebenden Dateieigenschaft enthält. property ist vom Datentyp varchar(128). Die folgenden Werte sind möglich:

    Wert

    Beschreibung

    Rückgabewert

    IsReadOnly

    Dateigruppe ist schreibgeschützt.

    1 = Wahr

    0 = Falsch

    NULL = Eingabe ist nicht gültig.

    IsPrimaryFile

    Datei ist die primäre Datei.

    1 = Wahr

    0 = Falsch

    NULL = Eingabe ist nicht gültig.

    IsLogFile

    Datei ist eine Protokolldatei.

    1 = Wahr

    0 = Falsch

    NULL = Eingabe ist nicht gültig.

    SpaceUsed

    Speicherplatz, der von der angegebenen Datei verwendet wird.

    Anzahl der in der Datei zugeordneten Seiten.

Rückgabetypen

int

Hinweise

file_name entspricht der name-Spalte in der Katalogsicht sys.master_files oder sys.database_files.

Beispiele

Das folgende Beispiel gibt die Einstellung für die IsPrimaryFile-Eigenschaft des AdventureWorks_Data-Dateinamens in der AdventureWorks-Datenbank zurück.

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

Dies ist das Resultset.

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

Siehe auch

Verweis

FILEGROUPPROPERTY (Transact-SQL)

Metadatenfunktionen (Transact-SQL)

sp_spaceused (Transact-SQL)

sys.database_files (Transact-SQL)

sys.master_files (Transact-SQL)