.NET 框架类库

X# Runtime and VO SDK Reference

X# Runtime and SDK Reference

Functions 方法

_DebOut32 方法

_GetCmdLine 方法

_GetCmdShow 方法

_GetInst 方法

_GetPrevInst 方法

_SplitPath 方法

AbsReal4 方法

AbsReal8 方法

AbsShort 方法

AdjustFName 方法

AdjustFNameA 方法

Ansi2Oem 方法

Ansi2OemA 方法

Ansi2OemBuff 方法

ATCLine2 方法

B64EncFile 方法

B64EncString 方法

Bin2Int64 方法

Bin2Logic 方法

Bin2Real4 方法

Bin2Real8 方法

CharEven 方法

ConDateTime 方法

CToDtAnsi 方法

CurDrive 方法

DateTime 方法

DbRegisterClient 方法

DbUnRegisterClient 方法

DebOut32 方法

DecodeBase64 方法

DirChange 方法

DirRemove 方法

DiskChange 方法

DiskFree 方法

DiskName 方法

DiskSpace 方法

DosError 方法

DosErrString 方法

ElapTime 方法

EncodeBase64 方法

ErrorBuild 方法

ErrorLevel 方法

ErrorStack 方法

ErrString 方法

ExecName 方法

FAttr2String 方法

FConvertToFileStream 方法

FConvertToMemoryStream 方法

FCreate2 方法

FException 方法

FFLock64 方法

FFUnLock 方法

FFUnLock64 方法

FGetBuffer 方法

FGetFileName 方法

FGetStream 方法

FPathName 方法

FReadLine 方法

FReadLine2 方法

FReadStr 方法

FReadText 方法

FReadText3 方法

FWriteLine 方法

FWriteLine3 方法

FWriteText3 方法

GetAMExt 方法

GetChunkBase64 方法

GetCurPath 方法

GetCursorProperty 方法

GetDateFormat 方法

GetDefault 方法

GetDefaultDir 方法

GetDosError 方法

GetFAttr 方法

GetFMask 方法

GetMacroCompiler 方法

GetMimType 方法

GetNatDLL 方法

GetPartialEnumName 方法

GetPMExt 方法

GetSQLProperty 方法

GetTimeSep 方法

GetTimeZoneDiff 方法

GetYield 方法

IsAlphaNum 方法

IsBDigit 方法

IsRunningOnWindows 方法

IsXDigit 方法

LockTries 方法

Logic2Bin 方法

MakeDWord 方法

MakeLong 方法

MakeShort 方法

MakeWord 方法

MemLines 方法

MemoLine 方法

MemoRead 方法

MemoReadBinary 方法

MemoWrit 方法

MemoWritBinary 方法

MLCount1 方法

MLcToPos 方法

ModuleName 方法

NToCMonth 方法

Oem2Ansi 方法

Oem2AnsiA 方法

Oem2AnsiBuff 方法

ProcFile 方法

ProcLine 方法

ProcName 方法

QPEncString 方法

RATLine2 方法

ReadOsVersionFromRegistry 方法

Real42Bin 方法

Real82Bin 方法

RegisterFileSearch 方法

Replicate 方法

SetAMExt 方法

SetCentury 方法

SetCollation 方法

SetCompatible 方法

SetDateCountry 方法

SetDateFormat 方法

SetDecimal 方法

SetDecimalSep 方法

SetDefault 方法

SetDefaultDir 方法

SetDeleted 方法

SetDigit 方法

SetDigitFixed 方法

SetEpoch 方法

SetErrorLog 方法

SetErrorLogFile 方法

SetErrorStackVOFormat 方法

SetExact 方法

SetExclusive 方法

SetFieldStore 方法

SetFixed 方法

SetInternational 方法

SetMacroCompiler 方法

SetMacroDuplicatesResolver 方法

SetNatDLL 方法

SetPathArray 方法

SetPMExt 方法

SetRefresh 方法

SetSafety 方法

SetScience 方法

SetSoftSeek 方法

SetSpace 方法

SetThousandSep 方法

SetTimeFormat 方法

SetTimeSep 方法

SetUnique 方法

SetYield 方法

String2FAttr 方法

SwapByte 方法

SwapDWord 方法

SwapInt64 方法

SwapLong 方法

SwapQWord 方法

SwapShort 方法

SwapWord 方法

SystemTypeToUsualType 方法

TruePath 方法

TypeString 方法

UseBufferedFileStream 方法

UUDecodeLine 方法

UUEncFile 方法

UUEncLine 方法

点击或拖拽改变大小

Functions.FFirst 方法

查找与给定文件规范或属性匹配的第一个文件。

命名空间： XSharp.Core
程序集： XSharp.Core (在 XSharp.Core.dll 中) 版本：2.22 GA

语法

 FUNCTION FFirst(
	pszFileSpec AS STRING,
	kAttributes AS DWORD
) AS LOGIC

public static bool FFirst(
	string pszFileSpec,
	uint kAttributes
)

参数

pszFileSpec: 类型：String
搜索的文件规范。除文件名外，此规范还可以包含可选的驱动器、目录和扩展名。
文件名和扩展名可以包含标准通配符（* 和 ?）。
如果省略驱动器和目录，则使用 Windows 默认值。
kAttributes: 类型：UInt32
以下一个或多个常量，指示要与 pszFileSpec 一起用作搜索条件的文件属性：
常量描述
FA_DIRECTORY 目录
FA_VOLUME 卷
FC_HIDDEN 隐藏
FC_NORMAL 可见
FC_SYSTEM 系统
要指定多个常量，可以将属性相加，如 FC_SYSTEM + FC_HIDDEN，或使用 _Or() 运算符，如 _Or(FC_SYSTEM, FC_HIDDEN)。
kAttributes 指定除与 pszFileSpec 匹配的任何"可见"文件之外要满足的条件。可见文件不包括目录、卷或隐藏或系统文件 — 所有其他文件都是可见的，无论其读取或存档属性的状态如何。
要仅包含可见文件，请使用 FC_NORMAL 作为 kAttributes 参数。
注意：要仅指定卷标，排除所有其他文件，请将 FA_VOLUME 指定为唯一的 kAttributes 参数。

返回值

类型：Boolean
如果找到匹配项，则为 TRUE；否则为 FALSE。

备注

FFirst() 获取第一个匹配的文件；使用 FNext() 查找后续匹配的文件。 FFCount() 返回匹配数。FAttrib()、FDate()、FName()、FSize() 和 FTime() 分别返回匹配文件的属性、日期戳、名称、大小和时间戳。

示例

此示例使用 FFirst() 查找文件：

X#

1IF FFirst("c:\docs\*.txt", FC_NORMAL)
2    ? "找到了一个文件"
3ELSE
4    ? "未找到文件"
5ENDIF

此示例说明了 kAttributes 参数的用法，将文件搜索扩展到包括隐藏文件和目录以及可见文件：

X#

1IF FFirst("c:\i*.*", FC_HIDDEN + FA_DIRECTORY)
2    ? "找到了一个文件"
3ELSE
4    ? "未找到文件"
5ENDIF

参见

引用

XSharp.Core 命名空间

FFCount(String, UInt32)

GetFMask(String)