System.Xml.XmlWriter.WriteQualifiedName 方法
上一篇：System.Xml.XmlDictionaryWriter.WriteProcessingInstruction 方法
下一篇：System.Xml.XmlDictionaryWriter.WriteQualifiedName(XmlDictionaryString,XmlDictionaryString) 方法
方法描述
当在派生类中被重写时，写出命名空间限定的名称。 此方法查找位于给定命名空间范围内的前缀。
语法定义(C# System.Xml.XmlWriter.WriteQualifiedName 方法 的用法)
public virtual void WriteQualifiedName( string localName, string ns )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| localName | System-String | 要编写的本地名称。 |
| ns | System-String | 名称的命名空间 URI。 |
| 返回值 | void |
提示和注释
如果 ns 映射到当前默认命名空间，则不生成前缀。
当编写特性值时，如果未找到 ns，则此方法生成前缀。 当编写元素内容时，如果未找到 ns，则它引发异常。
注意
如果从 XmlWriter 派生的类不重写此方法，则不检查 localName 是不是有效的 W3C XML 名称。 在此类情况下，可以在调用此方法之前通过 IsName 方法检查字符串的有效性。
System.Xml.XmlWriter.WriteQualifiedName 方法例子
该示例编写以下元素：
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
using (XmlWriter writer = XmlWriter.Create(Console.Out, settings))
{
writer.WriteStartElement("root");
writer.WriteAttributeString("xmlns", "x", null, "urn:abc");
writer.WriteStartElement("item");
writer.WriteStartAttribute("href", null);
writer.WriteString("#");
writer.WriteQualifiedName("test", "urn:abc");
writer.WriteEndAttribute();
writer.WriteEndElement();
writer.WriteEndElement();
}
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentException | localName 为 null 或 String.Empty。 localName 不是有效的名称。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1 受以下版本支持：
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。
上一篇：System.Xml.XmlDictionaryWriter.WriteProcessingInstruction 方法
下一篇：System.Xml.XmlDictionaryWriter.WriteQualifiedName(XmlDictionaryString,XmlDictionaryString) 方法