XmlTextReader.GetNamespacesInScope(XmlNamespaceScope) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a collection that contains all namespaces currently in-scope.
public:
System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ GetNamespacesInScope(System::Xml::XmlNamespaceScope scope);public System.Collections.Generic.IDictionary<string,string> GetNamespacesInScope (System.Xml.XmlNamespaceScope scope);member this.GetNamespacesInScope : System.Xml.XmlNamespaceScope -> System.Collections.Generic.IDictionary<string, string>Public Function GetNamespacesInScope (scope As XmlNamespaceScope) As IDictionary(Of String, String)Parameters
- scope
- XmlNamespaceScope
An XmlNamespaceScope value that specifies the type of namespace nodes to return.
Returns
An IDictionary object that contains all the current in-scope namespaces. If the reader is not positioned on an element, an empty dictionary (no namespaces) is returned.
Remarks
Note
Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.
The dictionary consists of a collection of namespace names keyed by prefix. It can be used to enumerate the in-scope namespaces. The dictionary is a disconnected copy of the namespace list of the reader. It remains unchanged as the reader position, current in-scope namespace list, changes.
The following table describes how the XmlNamespaceScope enumeration value affects the whether or not the default and built-in namespaces are returned by GetNamespacesInScope.
| XmlNamespaceScope Value | xmlns:xml | xmlns:xmlns | xmlns="" |
|---|---|---|---|
All |
yes | no | no |
ExcludeXml |
no | no | no |
Local |
no | no | yes |
