AdomdCommand.ExecuteXmlReader Method

Runs the AdomdCommand and returns an System.Xml.XmlReader.

Namespace:  Microsoft.AnalysisServices.AdomdClient
Assembly:  Microsoft.AnalysisServices.AdomdClient (in Microsoft.AnalysisServices.AdomdClient.dll)

Syntax

'Declaration
Public Function ExecuteXmlReader As XmlReader
'Usage
Dim instance As AdomdCommand
Dim returnValue As XmlReader

returnValue = instance.ExecuteXmlReader()
public XmlReader ExecuteXmlReader()
public:
XmlReader^ ExecuteXmlReader()
member ExecuteXmlReader : unit -> XmlReader 
public function ExecuteXmlReader() : XmlReader

Return Value

Type: System.Xml.XmlReader
An System.Xml.XmlReaderthat contains the results of the command.

Exceptions

Exception Condition
AdomdErrorResponseException

The provider returned an error in response.

AdomdUnknownResponseException

The provider sent an unrecognizable response.

AdomdConnectionException

The connection was broken.

System.InvalidOperationException

An error occurred because one of the following conditions was met:

Remarks

Instead of translating the XML for Analysis response from an XML format into an AdomdDataReader or CellSet, this method, returns an System.Xml.XmlReader that directly references the XML for Analysis response in its native XML format.

While the System.Xml.XmlReaderis in use, the associated AdomdConnection is busy serving the System.Xml.XmlReader. While in this state, the AdomdConnection can only be closed; no other operations can be performed on it. This remains the case until the Close method of the System.Xml.XmlReaderis called.

You should be prepared to catch any exception that can be thrown while using the System.Xml.XmlReader, such as the XmlException.