4.2.

函数

(Functions)

4.2.1.ComponentCreateFromXmlFile

　　

unit NativeXmlObjectStorage

　　

function

ComponentCreateFromXmlFile(const FileName: string; Owner: TComponent; const

Name: string): TComponent;

　　从文件名称为

FileName

的

XML

文件读取并创建组件。为了成功地从头开始创建组件，组件的类必须事先调用

RegisterClass

进行登记。添加到指定

Owner

组件的子组件列表。这通常是一个形式。指定

Name

作为创建的组件的新组件的名称。

　　注：它调用

ComponentCreateFromXmlStream

实现。

4.2.2.ComponentCreateFromXmlNode

　　

function ComponentCreateFromXmlNode(ANode:

TXmlNode; Owner: TComponent; const Name: string): TComponent;

　　从

TXmlNode

类型的

ANode

节点读取并创建组件。为了成功地从头开始创建组件，组件的类必须事先调用

RegisterClass

进行登记。添加到指定

Owner

组件的子组件列表。这通常是一个形式。指定

Name

作为创建的组件的新组件的名称。

　　注：它使用

TsdXmlObjectReader

类实现。

4.2.3.ComponentCreateFromXmlStream

　　

function

ComponentCreateFromXmlStream(S: TStream; Owner: TComponent; const Name:

string): TComponent;

　　从

XML

流类型的

S

中读取并创建组件。为了成功地从头开始创建组件，组件的类必须事先调用

RegisterClass

进行登记。添加到指定

Owner

组件的子组件列表。这通常是一个形式。指定

Name

作为创建的组件的新组件的名称。

　　注：它调用

ComponentCreateFromXmlNode

实现。

4.2.4.ComponentCreateFromXmlString

　　

function

ComponentCreateFromXmlString(const Value: string; Owner: TComponent; const

Name: string): TComponent;

　　从

XML

字符串类型的

Value

中读取并创建组件。为了成功地从头开始创建组件，组件的类必须事先调用

RegisterClass

进行登记。添加到指定

Owner

组件的子组件列表。这通常是一个形式。指定

Name

作为创建的组件的新组件的名称。

　　注：它调用

ComponentCreateFromXmlStream

实现。

4.2.5.ComponentSaveToXmlFile

　　

procedure

ComponentSaveToXmlFile(AComponent: TComponent; const FileName: string; AParent:

TComponent);

　　存储组件

AComponent

所有公布的属性到名为

FileName

的

XML

文件。指定

AParent

为了储存

Parent

正确的方法和事件参考。

　　注：它调用

ObjectSaveToXmlFile

实现。

4.2.6.ComponentSaveToXmlNode

　　

procedure

ComponentSaveToXmlNode(AComponent: TComponent; ANode: TXmlNode; AParent:

TComponent);

　　存储组件

AComponent

所有公布的属性到

TXmlNode

格式的

ANode

中。指定

AParent

为了储存

Parent

正确的方法和事件参考。

　　注：它调用

ObjectSaveToXmlNode

实现。

4.2.7.ComponentSaveToXmlStream

　　

procedure

ComponentSaveToXmlStream(AComponent: TComponent; S: TStream; AParent:

TComponent);

　　存储组件

AComponent

所有公布的属性到

XML

格式的流

S

中。指定

AParent

为了储存

Parent

正确的方法和事件参考。

　　注：它调用

ObjectSaveToXmlStream

实现。

4.2.8.ComponentSaveToXmlString

　　

function

ComponentSaveToXmlString(AComponent: TComponent; AParent: TComponent): string;

　　存储组件

AComponent

所有公布的属性到

XML

格式的字符串中。指定

AParent

为了储存

Parent

正确的方法和事件参考。

　　注：它调用

ObjectSaveToXmlString

实现。

4.2.9.DecodeBase64

　　

Unit NativeXml

　　

function DecodeBase64(const

Source: UTF8String): RawByteString;

　　解码

BASE64

的数据

Source

为二进制数据。该函数返回为

UTF8String

的二进制数据。使用

TStringStream

转换这些数据流。源

UTF8String

可能包含换行符和控制字符，这些符号将被忽略。

4.2.10.DecodeBinHex

　　

Unit NativeXml

　　

function DecodeBinHex(const

Source: UTF8String): RawByteString;

　　解码

BinHex

数据

Source

为二进制数据。该函数返回为

UTF8String

的二进制数据。使用

TStringStream

转换这些数据流。源

UTF8String

可能包含换行符和控制字符，这些符号将被忽略。

4.2.11.EncodeBase64

　　

Unit NativeXml

　　

function EncodeBase64(const

Source: RawByteString): UTF8String;

　　二进制数据

Source

编码为

BASE64

。该函数返回

UTF8String

格式的

BASE64

编码数据，没有任何换行符。

4.2.12.EncodeBinHex

　　

Unit NativeXml

　　

function EncodeBinHex(const

Source: RawByteString): UTF8String;

　　二进制数据

Source

编码为

BINHEX

。该函数返回

UTF8String

格式的

BINHEX

编码数据，没有任何换行符。

4.2.13.FormCreateFromXmlFile

　　

function

FormCreateFromXmlFile(const FileName: string; Owner: TComponent; const Name:

string): TForm;

　　从文件名称为

FileName

的

XML

文件读取并创建窗体。为了成功地从头开始创建窗体，窗体的类必须事先调用

RegisterClass

进行登记。添加窗体到指定

Owner

的子组件列表。这通常是一个形式。指定

Name

作为创建的窗体的新窗体的名称。

　　注：它调用

FormCreateFromXmlStream

实现。

4.2.14.FormCreateFromXmlStream

　　

function

FormCreateFromXmlStream(S: TStream; Owner: TComponent; const Name: string):

TForm;

　　从

XML

流格式的

S

读取并创建窗体。为了成功地从头开始创建窗体，窗体的类必须事先调用

RegisterClass

进行登记。添加窗体到指定

Owner

的子组件列表。这通常是一个形式。指定

Name

作为创建的窗体的新窗体的名称。

　　注：它调用

ComponentCreateFromXmlNode

实现。

4.2.15.FormCreateFromXmlString

　　

function

FormCreateFromXmlString(const Value: string; Owner: TComponent; const Name:

string): TForm;

　　从

XML

字符串格式的

Value

读取并创建窗体。为了成功地从头开始创建窗体，窗体的类必须事先调用

RegisterClass

进行登记。添加窗体到指定

Owner

的子组件列表。这通常是一个形式。指定

Name

作为创建的窗体的新窗体的名称。

　　注：它调用

FormCreateFromXmlStream

实现。

4.2.16.FormSaveToXmlFile

　　

procedure

FormSaveToXmlFile(AForm: TForm; const FileName: string);

　　存储窗体

AForm

到名为

FileName

的

XML

文件。这个方法存储窗体上所有的子组件，因而可以作为窗体存储的一种方法。

　　注：它调用

ComponentSaveToXmlFile

完成工作。

4.2.17.FormSaveToXmlStream

　　

procedure

FormSaveToXmlStream(AForm: TForm; S: TStream);

　　存储窗体

AForm

到

XML

流格式的

S

中。这个方法存储窗体上所有的子组件，因而可以作为窗体存储的一种方法。

　　注：它调用

ComponentSaveToXmlStream

实现。

4.2.18.FormSaveToXmlString

　　

function

FormSaveToXmlString(AForm: TForm): string;

　　存储窗体

AForm

到

XML

字符串格式中。这个方法存储窗体上所有的子组件，因而可以作为窗体存储的一种方法。

　　注：它调用

ComponentSaveToXmlString

实现。

4.2.19.ObjectLoadFromXmlFile

　　

procedure

ObjectLoadFromXmlFile(AObject: TObject; const FileName: string; AParent:

TComponent);

　　从文件名称为

FileName

的

XML

文件读取并创建

AObject

，并装入他所有公布的属性。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它调用

ObjectLoadFromXmlStream

实现。

4.2.20.ObjectLoadFromXmlNode

　　

procedure

ObjectLoadFromXmlNode(AObject: TObject; ANode: TXmlNode; AParent: TComponent);

　　从

TXmlNode

格式的

ANode

中读取并创建

AObject

，并装入他所有公布的属性。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它使用

TsdXmlObjectReader

类实现。

4.2.21.ObjectLoadFromXmlStream

　　

procedure

ObjectLoadFromXmlStream(AObject: TObject; S: TStream; AParent: TComponent);

　　从

XML

流格式的

S

中读取并创建

AObject

，并装入他所有公布的属性。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它调用

ObjectLoadFromXmlNode

实现。

4.2.22.ObjectLoadFromXmlString

　　

procedure ObjectLoadFromXmlString(AObject:

TObject; const Value: string; AParent: TComponent);

　　从

XML

字符串格式的

Value

中读取并创建

AObject

，并装入他所有公布的属性。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它调用

ObjectLoadFromXmlStream

实现。

4.2.23.ObjectSaveToXmlFile

　　

procedure

ObjectSaveToXmlFile(AObject: TObject; const FileName: string; AParent:

TComponent);

存储

AObject

所有公布的属性到文件名称为

FileName

的

XML

文件。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它调用

ObjectSaveToXmlStream

实现。

4.2.24.ObjectSaveToXmlNode

　　

procedure

ObjectSaveToXmlNode(AObject: TObject; ANode: TXmlNode; AParent: TComponent);

　　存储

AObject

所有公布的属性到

TXmlNode

类型的的

ANode

中。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它使用

TsdXmlObjectWriter

类实现。

4.2.25.ObjectSaveToXmlStream

　　

procedure

ObjectSaveToXmlStream(AObject: TObject; S: TStream; AParent: TComponent);

　　存储

AObject

所有公布的属性到

XML

流格式的

S

中。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它调用

ObjectSaveToXmlNode

实现。

4.2.26.ObjectSaveToXmlString

　　

function

ObjectSaveToXmlString(AObject: TObject; AParent: TComponent): string;

　　存储

AObject

所有公布的属性到

XML

字符串格式的

Value

中。指定

AParent

为了解决

Parent

正确的方法和事件参考。

　　注：它调用

ObjectSaveToXmlStream

实现。

4.2.27.sdAddControlChars

　　

Unit NativeXml

　　

function

sdAddControlChars(const AValue: UTF8String; const Chars: UTF8String; Interval:

integer): UTF8String;

　　这个函数将在

Interval

间隔的字符后，反复向

UTF8String

类型的

AValue

区间增加控制字符

Chars

。

4.2.28.sdAnsiToUtf8

　　

Unit NativeXml

　　

function sdAnsiToUtf8(const

S: AnsiString): UTF8String;

　　转换一个

AnsiString

类型字符串为一个

UTF8

编码字符串。

4.2.29.sdDateTimeFromString

　　

Unit NativeXml

　　

function

sdDateTimeFromString(const ADate: UTF8String; UseLocalBias: Boolean):

TDateTime;

　　根据

W3C

日期

/

时间规范，转换

UTF8String

类型的

ADate

为日期时间

(TDateTime)

类型，可以在

找到该规范。如果有一个转换错误，将引发异常。