XmlConvert.VerifyWhitespace(String) Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Zwraca przekazane wystąpienie ciągu, jeśli wszystkie znaki w argumencie ciągu są prawidłowymi znakami odstępu.

public:
 static System::String ^ VerifyWhitespace(System::String ^ content);

public static string VerifyWhitespace (string content);

static member VerifyWhitespace : string -> string

Public Shared Function VerifyWhitespace (content As String) As String

Parametry

content

String

String w celu zweryfikowania.

Zwraca

String

Przekazane wystąpienie ciągu, jeśli wszystkie znaki w argumencie ciągu są prawidłowymi znakami odstępu, w przeciwnym razie null.

Przykłady

W poniższym przykładzie użyto VerifyWhitespace metody do wykrycia obecności nieprawidłowego znaku w wartości przypisanej do elementu start.

XmlTextWriter writer5 = new XmlTextWriter("outFile.xml", null);
char illegalWhiteSpaceChar = '_';

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

    writer5.WriteStartElement("legalElement");
    // Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" +
        XmlConvert.VerifyWhitespace("\t" + illegalWhiteSpaceChar));

    // Write the end tag for the legal element.
    writer5.WriteEndElement();
    // Write the end tag for the root element.
    writer5.WriteEndElement();
    writer5.Close();
}
catch (Exception e)
{
    Console.WriteLine(e.Message);
    writer5.Close();
}

Dim writer5 As XmlTextWriter = New XmlTextWriter("outFile.xml", Nothing)
Dim illegalWhiteSpaceChar As Char = "_"

Try
    ' Write the root element.
    writer5.WriteStartElement("root")
    writer5.WriteStartElement("legalElement")
    ' Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" + _
        XmlConvert.VerifyWhitespace("   " + illegalWhiteSpaceChar))

    writer5.WriteEndElement()

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

    writer5.Close()

Catch e As XmlException
    Console.WriteLine(e.Message)
    writer5.Close()
End Try

Uwagi

Nie należy zwracać żadnych innych wartości niż przekazany argument. Znaki, które są prawidłowe dla białych znaków, nie różnią się między wersjami XML, więc nie jest wymagane przeciążenie wersji xml.

Aby uzyskać szczegółowe informacje na temat dozwolonych znaków, zobacz produkcja specyfikacji XML 1.0 (czwarta edycja) [3] S.

Jeśli parametr ma wartość null, ArgumentNullException zostanie zgłoszony element .

Jeśli którykolwiek z tych znaków nie jest prawidłowymi znakami odstępu, XmlException zostanie zgłoszony z informacjami o pierwszym napotkanym nieprawidłowym znaku.