Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Use this method to check whether an Extensible Markup Language (XML) fragment is a syntactically correct expression.
Definition
[Visual Basic .NET]
Imports Microsoft.CommerceServer.Interop.Targeting
…
Public Function ParseXML(bstrXMLExpr As String) As Boolean
[C#]
using Microsoft.CommerceServer.Interop.Targeting;
…
public void ParseXML(stringbstrXMLExpr);
Parameters
[Visual Basic .NET]
- bstrXMLExpr
A String that contains the XML text defining an expression.
[C#]
- bstrXMLExpr
A string that contains the XML text defining an expression.
Return Values
[Visual Basic .NET] This method returns a Boolean value indicating the results of parsing the expression (bstrXMLExpr).
[C#] This method returns a bool indicating the validity of the expression.
Exceptions
This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.
[Visual Basic .NET]
The following table shows the custom COM errors that a COMException can wrap.
| Value | Description |
|---|---|
| &H81100018 | Argument data type information missing from expression, or unrecognized argument data type encountered in expression |
| &H81100022 | Invalid expression argument value, or impossible conversion |
| &H81100016 | Invalid clause encountered |
| &H81100017 | Operator missing, unrecognized operator encountered, or type mismatch |
| &H81100015 | Term type missing, or unrecognized term type encountered |
| &H81100014 | Unrecognized XML element encountered |
| &H81100013 | XML DOM object parsing error |
[C#]
The following table shows the custom COM errors that COMException can wrap.
| Value | Description |
|---|---|
| 0x81100018 | Argument data type information missing from expression, or unrecognized argument data type encountered in expression |
| 0x81100022 | Invalid expression argument value, or impossible conversion |
| 0x81100016 | Invalid clause encountered |
| 0x81100017 | Operator missing, unrecognized operator encountered, or type mismatch |
| 0x81100015 | Term type missing, or unrecognized term type encountered |
| 0x81100014 | Unrecognized XML element encountered |
| 0x81100013 | XML DOM object parsing error |
Remarks
Because this method checks only syntax, the expression may still be invalid even though the method succeeds.
The expression store is not used for XML fragments.
[Visual Basic .NET]
Example
' sXMLExpr is a string.
' Note that this string is not formatted properly with respect to
' quotation marks or continuation in order to increase readability.
strXMLExpr = "<CLAUSE OPER="equal">
<PROPERTY ID="User.firstName" TYPE="string" />
<IMMED-VAL TYPE="string">Jill</IMMED-VAL>
</CLAUSE>"
' bResult is a Boolean
bResult = oExpressionEval.ParseXML(sXMLExpr)
Requirements
Namespace: Microsoft.CommerceServer.Interop.Targeting
Platforms: Windows 2000, Windows Server 2003
Assembly: exprarchlib (in exprarchlib.dll)
See Also
Copyright © 2005 Microsoft Corporation.
All rights reserved.