Delphi的TRegistry注册表类方法详解



●GetDataInfo方法

Function GetDataInfo(const ValueName:String;Var Value:TRegDataInfo):Boolean;

TregDataType=(rdunknown,rdstring,rdexpandstring,rdexpandstring,rdinterger,rdbinary);

TregDataInfo=record

　　　Regdata:TRegDataType;数据类型

　 dataSize:integer;数据大小

end

valuename:和当前键关联的数据值名称

value：返回数据的信息，如为rdstring和rdexpandstring类型，则数据大小包括字符串未尾的空结束字符。

　　如果成功返回True，失败返回False，并且Value的值为zeros

rdexpandstring：是一个包含环境变量的字符串;如“%PATH%”。


●CreateKey方法

Function CreateKey(const Key:string):Boolena;

　　新建一个名为Key的键，Key可以为绝对的或相对的名字，绝对名用反斜杠“\”开头，相对名是新建一个当前键的子键。新建没有值。

　　成功返回True，否则返回False,如果该键已存在将不产生效果。


●DeleteKey方法

Function DeleteKey(const Key:string):Boolean;

　　删除一个键及相关联的数据，在win95中子键也将被删除，NT中子键必须一个个删除。


●DeleteValue方法

Function DeleteValue (const Name:string):Boolean;

　　删除当前键中指定的一个数据值name。


●GetDataSize方法

Function GetDataSize(const ValueName:string):integer;

　　返回当前键中一个指定数值ValueName数据的大小。


●GetDataType方法

Function GetDataType(const Valuename;string):TRegDataType;

　　返回当前键中一个指定数值Valuename数据的类型。


●GetKeyInfo方法

Function GetKeyInfo(var value:TRegkeyinfo):Boolean;

　　返回当前键的信息，在于value中。

TRegkeyinfo=record

　 maxsubkeylen:integer;子键名的最长值（字节）

　 numvalues:integer;键值的数量

　 maxvaluelen;最长的键值名的长度

　 Filetime:TFileTime;最后一次更改的时间

end;


●Getkeynames方法

Procedure Getkeynames(strings:Tsrtings);

　　返回当前键所有子键的名子列表串。


●Getvaluenames

Procedure Getvaluenames(strings:Tstrings);

　 返回当前键所有键值名的列表串。


●Hassubkeys方法

Function hassubKeys:Boolean;

　　判断当前键是否有子键，有返回True，否则返回False。


●keyExists方法

Function KeyExists(const Key:string):Boolean;

　　判断指定的键是否存在。


●LoadKey方法

Function LoadKey(const Key,fileNmae:string):Boolean;

　在根键下新建

　从一个文件中加载注册信息到子键中，文件注册信息中包含数据值名、子键和数据。

　　LoadKey使创建一个键单一化，子键，键值和数据在一人操作中完成，所有这些称为一组，和单独地创建它们不同应用程序可以在一个文件中读取一组数据，这在用户运行中重新设置有特别的用处。

　Key为要创建子键的名子

　FileName：为文件的位置，所指定的文件必须为以前用SaveKey函数或RegSaveKey API函数所建立的，文件名不能包括扩展名。


●OpenKey方法

Function OpenKey(const Key:string;cancreate:Boolean):Boolean;

　　使用该函数可以指定一个键作为当前键，如果键为nil，则当前键 将设置为根键。

　　Cancreate决定是否在指定键不存在时创建该键，该函数创建的键的键值将不确定。

　　如果成功地打开或创建，该函数返回True。


●OpenKeyReadOnly方法

function OpenKeyReadOnly(const Key: String): Boolean;

　　以只读的方式打开Key值指定的键。


●CloseKey方法

procedure CloseKey;

　 当不再使用一个键时应用该方法关闭该键。


●MoveKey方法

procedure MoveKey(const OldName, NewName: String; Delete: Boolean);

　 该方法移动或复制一个键到一个新的位置，并把键的名子改为NewName。

　 在Win95/98下该的子键和数据将被一起移动或复制到新的位置，在NT下子键必须用MoveKey明确的移动或自制。


●读取数据的方法

function ReadBinaryData(const Name: String; var Buffer; BufSize: Integer):Integer;

function ReadBool(const Name: String): Boolean;

function ReadCurrency(const Name: String): Currency;

function ReadDate(const Name: String): TDateTime;

function ReadDateTime(const Name: String): TDateTime;

function ReadFloat(const Name: String): Double;

function ReadInteger(const Name: String): Integer;

function ReadString(const Name: String): String;

function ReadTime(const Name: String): TDateTime;

　　以上方法从当前主键读取相应数据类型的键值的数据，如果类型不匹配将产生一个异常。


●RegistryConnect方法

function RegistryConnect(const UNCName: String): Boolean;

　与另一台计算机的注册表建立连接，在建立连接前应将Rootkey属性设为HKEY_USERS或HKEY_LOCAL_MACHINE。

　UNCName是另一台计算机的名子。格式如：\\computername

　假如UNCName为nil，将打开本地计算机。