XmlConvert.EncodeLocalName(String) Methode

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konvertiert den Namen in einen gültigen lokalen XML-Namen.

public:
 static System::String ^ EncodeLocalName(System::String ^ name);

public static string EncodeLocalName (string name);

public static string? EncodeLocalName (string? name);

static member EncodeLocalName : string -> string

Public Shared Function EncodeLocalName (name As String) As String

Parameter

name: String

Der zu codierende Name.

Gibt zurück

String

Der codierte Name.

Beispiele

Im folgenden Beispiel werden Namen codiert und decodiert.

#using <System.dll>
#using <System.XML.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Encode and decode a name with spaces.
   String^ name1 = XmlConvert::EncodeName( "Order Detail" );
   Console::WriteLine( "Encoded name: {0}", name1 );
   Console::WriteLine( "Decoded name: {0}", XmlConvert::DecodeName( name1 ) );
   
   // Encode and decode a local name.
   String^ name2 = XmlConvert::EncodeLocalName( "a:book" );
   Console::WriteLine( "Encoded local name: {0}", name2 );
   Console::WriteLine( "Decoded local name: {0}", XmlConvert::DecodeName( name2 ) );
}

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));
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

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

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

  end sub
end class

Hinweise

Diese Methode ähnelt der EncodeName -Methode, mit der Ausnahme, dass sie das Doppelpunktzeichen codiert, wodurch sichergestellt wird, dass der Name als lokaler Nameteil eines namespacequalifizierten Namens verwendet werden kann.

Wenn Sie dieser Methode beispielsweise den ungültigen Namen a:b übergeben haben, wird a_x003a_b zurückgegeben, bei dem es sich um einen gültigen lokalen Namen handelt.

Wenn name oder System.String.Emptyistnull, gibt die Methode den gleichen Wert zurück.

Gilt für: