System.SysUtils.TSearchRec
Delphi
TSearchRec = record
private
function GetTimeStamp: TDateTime;
public
{$IFDEF MSWINDOWS}
Time: Integer platform deprecated;
{$ENDIF MSWINDOWS}
{$IFDEF POSIX}
Time: time_t platform;
{$ENDIF POSIX}
Size: Int64;
Attr: Integer;
Name: TFileName;
ExcludeAttr: Integer;
{$IFDEF MSWINDOWS}
FindHandle: THandle platform;
FindData: TWin32FindData platform;
{$ENDIF MSWINDOWS}
{$IFDEF POSIX}
Mode: mode_t platform;
FindHandle: Pointer platform;
PathOnly: string platform;
Pattern: string platform;
{$ENDIF POSIX}
property TimeStamp: TDateTime read GetTimeStamp;
end;
C++
struct DECLSPEC_DRECORD TSearchRec
{
private:
System::TDateTime __fastcall GetTimeStamp();
public:
int Time _DEPRECATED_ATTRIBUTE0 ;
__int64 Size;
int Attr;
TFileName Name;
int ExcludeAttr;
NativeUInt FindHandle;
_WIN32_FIND_DATAW FindData;
__property System::TDateTime TimeStamp = {read=GetTimeStamp};
};
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
record struct |
public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Beschreibung
TSearchRec definiert die zu suchenden Dateiinformationen für FindFirst und FindNext.
TSearchRec definiert die Dateiinformationen für die Suche mit den Funktionen FindFirst und FindNext. Wird eine Datei gefunden, werden die Felder des TSearchRec-Parameters modifiziert, um die gefundene Datei zu bestimmen.
Attr gibt die Dateiattribute der Datei an. Mit den folgenden Attributkonstanten kann getestet werden, welche Attribute für eine Datei gesetzt sind.
Anmerkung: Die Attributkonstanten werden direkt den DOS-Dateiattribute umgewandelt.
| Konstante | Wert | Beschreibung |
|---|---|---|
|
faReadOnly |
1 |
Schreibgeschützte Datei |
|
faHidden |
2 |
Verborgene Datei |
|
faSysFile |
4 |
Systemdatei |
|
faVolumeID |
8 |
Laufwerks-ID |
|
faDirectory |
16 |
Verzeichnis |
|
faArchive |
32 |
Archivdatei |
|
faSymLink |
64 |
Symbolische Verknüpfung |
|
faAnyFile |
71 |
Beliebige Datei |
Die Konstante faReadOnly hat denselben Namen wie der im Typ TFieldAttribute definierte Aufzählungswert. Wenn sowohl die Unit System.SysUtils und als auch die Unit Data.DB in die Quelldatei einbezogen sind, müssen Sie Zweideutigkeiten vermeiden, indem Sie die jeweilige Unit angeben, z.B. SysUtils.faReadOnly (Delphi) oder SysUtils::faReadOnly (C++).
Um ein Attribut zu testen, kombinieren Sie mit Hilfe des and-Operators den Wert des Attr-Feldes mit der Attributkonstante. Besitzt die Datei das betreffende Attribut, ist der zurückgegebene Wert größer als 0. Wurde beispielsweise eine verborgene Datei gesucht, ergibt der folgende Ausdruck True:
(SearchRec.Attr and faHidden) <> 0.
(SearchRec.Attr & faHidden) != 0.
Time enthält den Zeitstempel der Datei. Mit FileDateToDateTime kann dieser Wert in einen TDateTime-Wert konvertiert werden.
Size enthält die Größe in Byte.
Name enthält den Basisdateinamen sowie die Namenserweiterung.
FindHandle enthält ein internes Handle, mit dem der Status des Suchvorgangs protokolliert wird.
FindData (nur Windows) enthält zusätzliche Informationen wie Erstellungszeit, Zeit des letzten Zugriffs und den langen sowie kurzen Dateinamen.
Mode (nur Linux) enthält die Berechtigungsmaske der Datei.
Siehe auch
Codebeispiele