X# Runtime and VO SDK Reference
X# Runtime and SDK Reference
XSharp.VFP
Functions 类
Functions 方法
AClass 方法
ADatabases 方法
ADBObjects 方法
AddBs 方法
AddProperty 方法
ADel 方法
ADLLS 方法
ADOCKSTATE 方法
AElement 方法
AERROR 方法
AEVENTS 方法
AFONT 方法
AGETCLASS 方法
AGetFileVersion 方法
AIns 方法
AINSTANCE 方法
ALANGUAGE 方法
ALen 方法
ALines 方法
AllTrim 方法
AMembers 方法
AMOUSEOBJ 方法
ANetResources 方法
APrinters 方法
APROCINFO 方法
ASELOBJ 方法
ASessions 方法
ASize 方法
ASqlHandles 方法
AStackInfo 方法
ASubScript 方法
At 方法
At_C 方法
ATagInfo 方法
AtC 方法
AtCC 方法
AUsed 方法
AVCXCLASSES 方法
BagCount 方法
BAR 方法
BARCOUNT 方法
BARPROMPT 方法
BINDEVENT 方法
BinToc 方法
BitAnd 方法
BitClear 方法
BitLShift 方法
BitNot 方法
BitOr 方法
BitRShift 方法
BitSet 方法
BitTest 方法
BitXor 方法
Candidate 方法
CapsLock 方法
Cdx 方法
Ceiling 方法
ChrTran 方法
ChrTranC 方法
COMARRAY 方法
COMCLASSINFO 方法
CompObj 方法
COMPROP 方法
COMRETURNERROR 方法
CpConvert 方法
CpCurrent 方法
CpDbf 方法
CREATEBINARY 方法
CreateObject 方法
CreateObjectEx 方法
CreateOffline 方法
CToBin 方法
CToT 方法
CursorGetProp 方法
CursorSetProp 方法
CursorToXML 方法
CurVal 方法
DbAlias 方法
DbAppDelimFox 方法
DbAppendFromArray 方法
DbAppFox 方法
Dbc 方法
DbCopyDelimFox 方法
DbCopyFox 方法
DbCopyStructFox 方法
DbCopyToArray 方法
DbCopyXStructFox 方法
DbGetProp 方法
DbSeekFox 方法
DbSetProp 方法
DbSortFox 方法
DbUseAreaFox 方法
DbUsed 方法
DDEAbortTrans 方法
DDEAdvise 方法
DDEEnabled 方法
DDEExecute 方法
DDEInitiate 方法
DDELastError 方法
DDEPoke 方法
DDERequest 方法
DDESetOption 方法
DDESetService 方法
DDESetTopic 方法
DDETerminate 方法
DefaultExt 方法
Descending 方法
Difference 方法
DisplayPath 方法
DMY 方法
DriveType 方法
DropOffLine 方法
DToT 方法
EDITSOURCE 方法
ERROR 方法
EVENTHANDLER 方法
EVL 方法
Field 方法
FileToStr 方法
Filter 方法
FKLABEL 方法
FKMAX 方法
FldCount 方法
FldList 方法
FontMetric 方法
For 方法
ForceExt 方法
ForcePath 方法
FullPath 方法
FV 方法
GetAutoIncValue 方法
GETBAR 方法
GetColor 方法
GetCp 方法
GetCursorAdapter 方法
GetDir 方法
GetFile 方法
GetFldState 方法
GetFont 方法
GETINTERFACE 方法
GetNextModified 方法
GetObject 方法
GETPAD 方法
GETPEM 方法
GetPict 方法
GetPrinter 方法
GetResultSet 方法
GetWordCount 方法
GetWordNum 方法
GoMonth 方法
HOME 方法
Hour 方法
ICase 方法
Id 方法
IdxCollate 方法
ImeStatus 方法
InDbc 方法
IndexSeek 方法
INKEY 方法
InputBox 方法
InsMode 方法
IsBlank 方法
IsColor 方法
IsExclusive 方法
IsFlocked 方法
ISLEADBYTE 方法
IsMemoFetched 方法
IsMouse 方法
IsNull 方法
IsPen 方法
IsReadOnly 方法
IsRlocked 方法
IsTransactable 方法
JustDrive 方法
JustExt 方法
JustFName 方法
JustPath 方法
JustStem 方法
Key 方法
KeyMatch 方法
LASTKEY 方法
LeftC 方法
LenC 方法
LikeC 方法
LineNo 方法
LoadPicture 方法
LocFile 方法
Lock 方法
Lookup 方法
LTrim 方法
MakeTransactable 方法
Mdx 方法
MDY 方法
MEMORY 方法
MENU 方法
MESSAGE 方法
MessageBox 方法
Minute 方法
MkDir 方法
MRKBAR 方法
MRKPAD 方法
MROW 方法
MToN 方法
MWINDOW 方法
Ndx 方法
NewObject 方法
Normalize 方法
NToM 方法
NumLock 方法
NVL 方法
OBJTOCLIENT 方法
OldVal 方法
ON 方法
Order 方法
PAD 方法
PADPROMPT 方法
PARAMETERS 方法
Payment 方法
PCol 方法
PEMSTATUS 方法
POPUP 方法
Primary 方法
PRINTSTATUS 方法
PRMBAR 方法
PRMPAD 方法
Program 方法
PROMPT 方法
PRow 方法
PrtInfo 方法
PutFile 方法
PV 方法
Quarter 方法
RaiseEvent 方法
RAt 方法
RAtC 方法
RDLEVEL 方法
READKEY 方法
Refresh 方法
RegisterFoxMemVarSupport 方法
Relation 方法
RemoveProperty 方法
Requery 方法
RgbScheme 方法
RightC 方法
RTrim 方法
SavePicture 方法
Scheme 方法
SCOLS 方法
Sec 方法
Seek 方法
SetFldState 方法
SetFoxCollation 方法
SetResultSet 方法
SetTextFile 方法
SetTextMerge 方法
SetTextMergeDelimiters 方法
ShowFoxArray 方法
Sign 方法
SKPBAR 方法
SKPPAD 方法
SqlCancel 方法
SqlColumns 方法
SqlCommit 方法
SqlConnect 方法
SqlDisconnect 方法
SqlExec 方法
SqlGetProp 方法
SqlIdleDisconnect 方法
SqlMoreResults 方法
SqlParameters 方法
SqlPrepare 方法
SqlRollBack 方法
SqlSetFactory 方法
SqlSetProp 方法
SqlStringConnect 方法
SqlTables 方法
SROWS 方法
Str 方法
StrConv 方法
StrExtract 方法
StrToFile 方法
StuffC 方法
SubStrC 方法
Sys 方法
SysMetric 方法
TableRevert 方法
TableUpdate 方法
Tag 方法
TagCount 方法
TagNo 方法
Target 方法
TextMerge 方法
Transform 方法
Trim 方法
TToC 方法
TToD 方法
TxnLevel 方法
TxtWidth 方法
UNBINDEVENTS 方法
Unique 方法
UPDATED 方法
VARREAD 方法
VarType 方法
WBORDER 方法
WCHILD 方法
WCOLS 方法
WDOCKABLE 方法
Week 方法
WEXIST 方法
WFONT 方法
WLAST 方法
WLCOL 方法
WLROW 方法
WMAXIMUM 方法
WMINIMUM 方法
WONTOP 方法
WOUTPUT 方法
WPARENT 方法
WREAD 方法
WROWS 方法
WTITLE 方法
WVISIBLE 方法
XmlToCursor 方法
XmlUpdatefram 方法
点击或拖拽改变大小

Functions.XmlUpdatefram 方法

X#
-- todo --
将缓冲表或游标中的更改镜像到XML UpdateGram中，并返回包含UpdateGram的字符串。
XML UpdateGram表示X#表或游标中已更改部分的前后状态。通过额外的处理， 您可以使用UpdateGram将这些更改提交到XML UpdateGram文档所代表的数据。
备注 备注：
要使用XMLUpdateGRAM( )，您必须使用Set MultiLocks ON并启用表缓冲。
备注 备注：
在调用XMLUpdateGRAM( )之前，您应该通过对现有游标和表调用CursorSetProp( ) 并使用KeyFieldList属性来指定键字段列表。如果不指定键字段， 前后表示中都将包含表中的所有字段。如果指定一个或多个键字段，只有这些字段会出现在前部分。

命名空间：  XSharp.VFP
程序集：  XSharp.VFP (在 XSharp.VFP.dll 中) 版本：2.22 GA
语法
复制
 FUNCTION XmlUpdatefram(
	cAliasList,
	nFlags,
	cSchemaLocation
) AS STRING CLIPPER
查看代码

参数

cAliasList (Optional)
类型：__Usual
指定要包含在XML UpdateGram中的打开表或游标的逗号分隔列表，可以按名称或工作区号列出，或两者的任意组合。 如果不为cAliasList指定值或指定空字符串（""），X#将使用当前数据会话中所有包含缓冲更改的打开表和游标。
nFlags (Optional)
类型：__Usual
指定是否返回格式化文件。备注部分的表格列出了nFlags的累加标志。
cSchemaLocation (Optional)
类型：__Usual
指定映射架构（如果存在）的名称和位置。
备注 备注：
您必须提供映射架构。
例如，假设您将名为mySchema.xsd的架构传递给cSchemaLocation，创建的UpdateGram将包含一个映射架构属性， 如以下XML所示：
X#
复制
1<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
2<updg:sync mapping-schema="mySchema.xsd" >
3<updg:before>

返回值

类型：String
字符数据类型。XMLUpdateGRAM( )返回一个包含XML UpdateGram的字符串。
备注
您可以将XMLUpdateGRAM( )与X#的OLE DB提供程序一起使用。但是，_VFPVFPXMLProgID属性不受支持， 因为OLE DB提供程序不支持_VFP系统变量。
备注 备注：
要将X# OLE DB提供程序与XMLUpdateGRAM( )一起使用， 您必须在安装OLE DB提供程序的计算机上安装MSXML 3.0。
SQL Server和Visual Studio支持DiffGram格式来更新XML。但是，SQL XML需要映射架构来支持此格式。 因此，XMLUpdateGRAM( )不支持此格式。
为避免XMLUpdateGRAM( )在包含Memo或General字段的表上可能产生的错误， 请使用CursorSetProp( )函数。以下示例展示了如何通过使用CursorSetProp( )设置 KeyFieldList属性来在XML UpdateGram中包含备注数据：
X#
复制
 1Set MultiLocks ON
 2Create CURSOR Test (mField M, cField I AutoInc)
 3Insert Into Test (mField) VALUES ("123456789")
 4Insert Into Test (mField) VALUES ("23456789")
 5Insert Into Test (mField) VALUES ("3456789")
 6Insert Into Test (mField) VALUES ("456789")
 7CursorSetProp("Buffering",5)
 8CursorSetProp("keyfieldlist",'cField')
 9Update Test Set mField = "XXXXXXX" Where cField < 3
10StrToFile(XMLUpdateGRAM(),'xmlupdate.txt')
11MODIFY FILE xmlupdate.txt
12RETURN
要将XML UpdateGram中的备注数据写入SQL Server，您必须在SQL Server上使用显式架构， 并在XML UpdateGram中引用该架构。
与CURSORTOXML( )函数不同，XMLUpdateGRAM( )忽略Set Fields语句，直接从底层游标读取。 要在调用XMLUpdateGRAM( )之前更改表结构，您必须将数据复制到新游标中。例如， 要将Numeric字段更改为Currency字段，以下示例使用SQL Select语句创建新游标， 并将该游标与XMLUpdateGRAM( )一起使用。该示例将Total_Price字段转换为货币字段，使用 CursorSetProp( )启用缓冲，使用Replace命令添加销售税，并使用 XMLUpdateGRAM( )函数创建XML UpdateGram。
X#
复制
1Select OrderID, CustID, NTOM(Total_Price) as Total_Price;
2From Orders Into CURSOR New_Orders READWRITE
3CursorSetProp("Buffering", 5, "New_Orders")
4Replace Total_Price WITH (Total_Price * 1.083)
5cXMLUpdg = XMLUpdateGRAM("New_Orders")
使用标志32768时，标志16和32的设置可能会影响应用哪个代码页，这取决于您要写入XML的数据类型。 以下表格显示了可能的设置组合及每种组合应用的代码页。
对于使用32768标志设置写入的XML文档，应用以下代码页。
标志16标志32设置标志32768
未设置未设置 XML文档：Windows-1252。 Unicode数据：代码页1252。 字符数据：默认代码页，除非字段标记为NOCPTRANS。
True (.T)未设置 XML文档：游标的CodePage属性。如果XMLField CodePage属性大于零(0) 且与游标的代码页不匹配，则报告错误。
Unicode数据：游标对象的Code page属性。
字符数据：无。改用来自X#表(.dbf)的原始数据。
未设置设置 XML文档：UTF-8代码页。
Unicode数据：UTF-8代码页。
字符数据：默认代码页，除非字段标记为NOCPTRANS， 在这种情况下不会进行额外的字符转换为UTF-8。
设置设置 XML文档：UTF-8代码页。
Unicode数据：UTF-8代码页。
字符数据：默认代码页，除非字段标记为NOCPTRANS， 在这种情况下，使用SYS(3005)设置将数据转换为UTF-8。
对于未设置32768标志写入的XML文档，应用以下代码页。
标志16标志32不带32768标志
未设置未设置 XML文档：Windows-1252。
Unicode数据：代码页1252。
字符数据：默认代码页，除非字段标记为NOCPTRANS。
True (.T)未设置 XML文档：游标的CodePage属性。 字符数据：无。改用来自X#表(.dbf)的原始数据。 Unicode数据：游标对象的代码页属性。
未设置设置 XML文档：UTF-8代码页。 Unicode数据：UTF-8代码页。 字符数据：默认代码页，除非字段标记为NOCPTRANS，在这种情况下不会进行额外的字符转换为UTF-8。
设置设置 XML文档：UTF-8代码页。
Unicode数据：UTF-8代码页。
字符数据：默认代码页，除非字段标记为NOCPTRANS，在这种情况下， 它们使用当前SYS(3005)设置的代码页转换为UTF-8。
有关将XML转换为X#数据的更多信息，请参阅"在XML和X#数据之间转换"。
nFlag位输出描述
00000（默认）使用UTF-8格式的XML。
10001使用未格式化的XML，例如连续字符串XML。
20010用开放和关闭元素包围空元素，例如<cc04></cc04>。
40100保留字段中的空白。
81000将Memo字段包装在CDATA部分中。
1610000输出编码。
32100000输出编码。
32768无表示应使用代码页。
备注 备注：
当输出编码为UTF-8（默认）时，XML声明不包含Encoding=属性 （无编码属性 = UTF-8）。
当输出编码设置为默认为游标或表的代码页时，编码属性将根据以下表格写入。
备注 备注：
通过组合第4位和第5位（0010000）设置编码标志。
编码标志第4位和第5位描述
+000（默认）Windows 1252
+1601将输出编码属性设置为游标的代码页。
+3210将输出编码属性设置为UTF-8（无字符转换）。
+4811将输出编码属性设置为UTF-8，并将双字节字符转换为UTF-8。
参见