XmlConvert.VerifyXmlChars(String) メソッド

定義

名前空間:
System.Xml
アセンブリ:
System.Xml.dll, System.Xml.ReaderWriter.dll
アセンブリ:
netstandard.dll, System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.dll
アセンブリ:
netstandard.dll
ソース:
XmlConvert.cs
ソース:
XmlConvert.cs
ソース:
XmlConvert.cs
ソース:
XmlConvert.cs
ソース:
XmlConvert.cs

文字列引数内のすべての文字とサロゲート ペア文字が有効な XML 文字である場合は、渡された文字列を返します。それ以外の場合は、最初に検出された無効な文字に関する情報を含む XmlException がスローされます。

public:
 static System::String ^ VerifyXmlChars(System::String ^ content);
public static string VerifyXmlChars(string content);
static member VerifyXmlChars : string -> string
Public Shared Function VerifyXmlChars (content As String) As String

パラメーター

content
String

String 検証する文字を含む

返品

String

文字列引数内のすべての文字とサロゲート ペア文字が有効な XML 文字である場合は、渡された文字列。それ以外の場合は、最初に検出された無効な文字に関する情報を含む XmlException がスローされます。

例

次の例では、start 要素内の無効な文字を検出するために使用する VerifyXmlChars メソッドを使用します。

XmlTextWriter writer3 = new XmlTextWriter("outFile.xml", null);
char illegalChar = '\uFFFE';
string charsToVerify = "Test String ";

try
{
    // Write the root element.
    writer3.WriteStartElement("root");

    // Throw an exception due illegal character.
    writer3.WriteStartElement(
        XmlConvert.VerifyXmlChars(charsToVerify + illegalChar));

    writer3.WriteString("ValueText");
    writer3.WriteEndElement();

    // Write the end tag for the root element.
    writer3.WriteEndElement();

    writer3.Close();
}
catch (XmlException e)
{
    Console.WriteLine(e.Message);
    writer3.Close();
}

Dim writer3 As XmlTextWriter = New XmlTextWriter("outFile.xml", Nothing)
Dim illegalChar As Char = ChrW(CInt("&hFFFE"))
Dim charsToVerify As String = "Test String "

Try
    ' Write the root element.
    writer3.WriteStartElement("root")

    ' Throw an exception for name that contains illegal character.
    writer3.WriteStartElement( _
        XmlConvert.VerifyXmlChars(charsToVerify + illegalChar))

    writer3.WriteString("ValueText")
    writer3.WriteEndElement()

    ' Write the end tag for the root element.
    writer3.WriteEndElement()

    writer3.Close()


Catch e As XmlException

    Console.WriteLine(e.Message)
    writer3.Close()
End Try

注釈

渡された引数以外の値は返されません。 使用できる文字の詳細については、 XML 1.0 仕様 (第 4 版) の運用 [2] Char を参照してください。

パラメーターが null の場合、 ArgumentNullException がスローされます。 いずれかの文字が有効な xml 文字でない場合は、最初に検出された無効な文字に関する情報を含む XmlException がスローされます。

適用対象