Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

XmlWriter::WriteQualifiedName Method (String^, String^)

.NET Framework (current version)
 

When overridden in a derived class, writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace.

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

C#
C++
F#
VB
Copy 
public:
virtual void WriteQualifiedName(
	String^ localName,
	String^ ns
)

Parameters

localName
Type: System::String^

The local name to write.

ns
Type: System::String^

The namespace URI for the name.

Exception Condition
ArgumentException

localName is either null or String.Empty.

localName is not a valid name.

InvalidOperationException

An XmlWriter method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.”

If ns maps to the current default namespace, no prefix is generated.

When writing attribute values, this method generates a prefix if ns is not found. When writing element content, it throws an exception if ns is not found.

System_CAPS_noteNote

If a class derived from the XmlWriter does not override this method localName is not checked to be a valid W3C XML name. In such case, before calling this method, the validity of the string can be checked by IsName method.

For the asynchronous version of this method, see WriteQualifiedNameAsync.

The example writes the following element:

Copy 
<root xmlns:x="urn:abc">
  <item href="#x:test"/>
</root>
C#
VB
C++
Copy
No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: