This documentation is archived and is not being maintained.

XPathQueryGenerator Class

When given a class representing a data contract, and metadata representing a member of the contract, produces an XPath query for the member.

System::Object
  System.Runtime.Serialization::XPathQueryGenerator

Namespace:  System.Runtime.Serialization
Assembly:  System.Runtime.Serialization (in System.Runtime.Serialization.dll)

public ref class XPathQueryGenerator abstract sealed

  NameDescription
Public methodStatic memberCreateFromDataContractSerializer(Type, array<MemberInfo>, XmlNamespaceManager%)Creates an XPath from a data contract using the specified data contract type, array of metadata elements, and namespaces..
Public methodStatic memberCreateFromDataContractSerializer(Type, array<MemberInfo>, StringBuilder, XmlNamespaceManager%)Creates an XPath from a data contract using the specified contract data type, array of metadata elements, the top level element, and namespaces.
Top

For more information about data contracts, see Using Data Contracts.

To use the class, there are four steps:

  1. Create the data contract type by applying the DataContractAttribute and DataMemberAttribute as appropriate to the type and its fields or properties.

  2. Use the GetMember() method of the Type class to generate the MemberInfo array.

  3. Pass the type and the array to the method.

  4. If needed, use the XmlNamespaceManager returned by the namespaces parameter to examine the XML namespaces referenced by the namespaces prefixes in the XPath query.

NoteNote

The namespace prefix "xg" (for "XPath Generator") is used as the default in the XPath. This cannot be changed. Instead, refer to the NameTable collection to see what namespace the prefix is associated with.

The following example creates XPath queries from two classes to which the DataContractAttribute and DataMemberAttribute attributes have been applied.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: