Delphi操作XML:函数详解(一)

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)类型，可以在http://www.w3.org/TR/NOTE-datetime找到该规范。如果有一个转换错误，将引发异常。