System.Xml.XmlConvert.EncodeLocalName 方法

方法描述

将名称转换为有效的 XML 本地名称。

语法定义(C# System.Xml.XmlConvert.EncodeLocalName 方法 的用法)

public static string EncodeLocalName(
	string name
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
name System-String 要编码的名称。
返回值 System.String 已编码的名称。

提示和注释

该方法与 EncodeName 方法相似,只是它对冒号字符进行编码,这保证该名称可以用作命名空间限定名的本地名称部分。

例如,如果您向此方法传递无效的名称 a:b,它返回 a_x003a_b,这是一个有效的本地名称。

如果 name 为 null 或 String.Empty,则返回相同的值。

System.Xml.XmlConvert.EncodeLocalName 方法例子

下面的示例对名称进行编码和解码。

using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {

     // Encode and decode a name with spaces.
     string name1 = XmlConvert.EncodeName("Order Detail");
     Console.WriteLine("Encoded name: " + name1);
     Console.WriteLine("Decoded name: " + XmlConvert.DecodeName(name1));

     // Encode and decode a local name.
     string name2 = XmlConvert.EncodeLocalName("a:book");
     Console.WriteLine("Encoded local name: " + name2);
     Console.WriteLine("Decoded local name: " + XmlConvert.DecodeName(name2));

  }
}

异常

异常 异常描述

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

版本信息

.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 系统要求。