Compartilhar via


XmlSchemaDatatype.ParseValue Método

Definição

Sobrecargas

Nome Description
ParseValue(String, XmlNameTable, IXmlNamespaceResolver)

Quando substituído em uma classe derivada, valida o string especificado em relação a um tipo simples interno ou definido pelo usuário.

ParseValue(String, XmlNameTable, XmlNamespaceManager)

Quando substituído em uma classe derivada, valida a cadeia de caracteres especificada em relação a um tipo simples interno ou definido pelo usuário.

ParseValue(String, XmlNameTable, IXmlNamespaceResolver)

Origem:
XmlSchemaDataType.cs
Origem:
XmlSchemaDataType.cs
Origem:
XmlSchemaDataType.cs
Origem:
XmlSchemaDataType.cs
Origem:
XmlSchemaDataType.cs

Quando substituído em uma classe derivada, valida o string especificado em relação a um tipo simples interno ou definido pelo usuário.

public:
 abstract System::Object ^ ParseValue(System::String ^ s, System::Xml::XmlNameTable ^ nameTable, System::Xml::IXmlNamespaceResolver ^ nsmgr);
public abstract object ParseValue(string s, System.Xml.XmlNameTable? nameTable, System.Xml.IXmlNamespaceResolver? nsmgr);
public abstract object ParseValue(string s, System.Xml.XmlNameTable nameTable, System.Xml.IXmlNamespaceResolver nsmgr);
abstract member ParseValue : string * System.Xml.XmlNameTable * System.Xml.IXmlNamespaceResolver -> obj
Public MustOverride Function ParseValue (s As String, nameTable As XmlNameTable, nsmgr As IXmlNamespaceResolver) As Object

Parâmetros

s
String

A string validação em relação ao tipo simples.

nameTable
XmlNameTable

O XmlNameTable a ser usado para atomização ao analisar se string esse XmlSchemaDatatype objeto representa o tipo xs:NCName.

nsmgr
IXmlNamespaceResolver

O IXmlNamespaceResolver objeto a ser usado ao analisar se string esse XmlSchemaDatatype objeto representa o tipo xs:QName.

Retornos

Um Object que pode ser convertido com segurança no tipo retornado pela ValueType propriedade.

Exceções

O valor de entrada não é uma instância válida desse tipo de esquema XML W3C.

O valor a ser analisado não pode ser null.

Exemplos

O exemplo a seguir recupera o LotteryNumber tipo simples do arquivo example.xsd como um XmlSchemaSimpleType e valida o string valor de 5 usar o ParseValue método.

using System;
using System.Xml;
using System.Xml.Schema;

class XMLSchemaExamples
{
    public static void Main()
    {
        XmlTextReader xtr = new XmlTextReader("example.xsd");
        XmlSchema schema = XmlSchema.Read(xtr, new ValidationEventHandler(ValidationCallbackOne));

        XmlSchemaSet schemaSet = new XmlSchemaSet();
        schemaSet.ValidationEventHandler += new ValidationEventHandler(ValidationCallbackOne);
        schemaSet.Add(schema);
        schemaSet.Compile();

        XmlSchema compiledSchema = null;

        foreach (XmlSchema schema1 in schemaSet.Schemas())
        {
            compiledSchema = schema1;
        }

        foreach (XmlSchemaObject schemaObject in compiledSchema.Items)
        {
            if (schemaObject.GetType() == typeof(XmlSchemaSimpleType))
            {
                XmlSchemaSimpleType simpleType = (XmlSchemaSimpleType)schemaObject;
                Console.WriteLine("{0} {1}", simpleType.Name, simpleType.Datatype.ValueType);
            }
            if (schemaObject.GetType() == typeof(XmlSchemaComplexType))
            {
                XmlSchemaComplexType complexType = (XmlSchemaComplexType)schemaObject;
                Console.WriteLine("{0} {1}", complexType.Name, complexType.Datatype.ValueType);
            }
        }
        xtr.Close();
    }

    public static void ValidationCallbackOne(object sender, ValidationEventArgs args)
    {
        Console.WriteLine(args.Message);
    }
}
Imports System.Xml
Imports System.Xml.Schema

 _

Class XMLSchemaExamples

    Public Shared Sub Main()
        Dim xtr As New XmlTextReader("example.xsd")
        Dim schema As XmlSchema = XmlSchema.Read(xtr, New ValidationEventHandler(AddressOf ValidationCallbackOne))

        Dim schemaSet As New XmlSchemaSet()
        AddHandler schemaSet.ValidationEventHandler, AddressOf ValidationCallbackOne

        schemaSet.Add(schema)
        schemaSet.Compile()

        Dim compiledSchema As XmlSchema = Nothing

        For Each schema1 As XmlSchema In schemaSet.Schemas()
            compiledSchema = schema1
        Next

        Dim schemaObject As XmlSchemaObject
        For Each schemaObject In compiledSchema.Items
            If schemaObject.GetType() Is GetType(XmlSchemaSimpleType) Then
                Dim simpleType As XmlSchemaSimpleType = CType(schemaObject, XmlSchemaSimpleType)
                Console.WriteLine("{0} {1}", simpleType.Name, simpleType.Datatype.ValueType)
            End If
            If schemaObject.GetType() Is GetType(XmlSchemaComplexType) Then
                Dim complexType As XmlSchemaComplexType = CType(schemaObject, XmlSchemaComplexType)
                Console.WriteLine("{0} {1}", complexType.Name, complexType.Datatype.ValueType)
            End If
        Next schemaObject
        xtr.Close()
    End Sub


    Public Shared Sub ValidationCallbackOne(ByVal sender As Object, ByVal args As ValidationEventArgs)
        Console.WriteLine(args.Message)
    End Sub
End Class

O arquivo XML a seguir é usado para o exemplo de código anterior.

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:simpleType name="LotteryNumber">
        <xs:restriction base="xs:int">
            <xs:minInclusive value="1"/>
            <xs:maxInclusive value="99"/>
        </xs:restriction>
    </xs:simpleType>
</xs:schema>

Comentários

O ParseValue método valida o string especificado em relação a um tipo simples interno ou definido pelo usuário. Por exemplo, se isso XmlSchemaDatatype representar o tipo xs:date, uma instância será DateTime retornada.

Veja a seguir as etapas executadas durante o ParseValue processo de validação do método.

  1. Converta o valor especificado como um string em seu tipo CLR (Common Language Runtime) correspondente.

  2. Verifique se o valor não viola nenhuma faceta definida para o tipo simples.

Em seguida, o valor convertido é retornado como um Object e pode ser convertido com segurança para o tipo retornado pela ValueType propriedade.

Quando o XmlSchemaDatatype objeto representa um tipo de lista, o valor de entrada string é convertido em uma lista de um ou mais objetos. Quando o XmlSchemaDatatype objeto representa um tipo de lista, é feita uma tentativa de analisar o valor de entrada como um tipo de membro da união. Se a tentativa de análise falhar, a conversão será tentada com o próximo membro da união até que a análise seja bem-sucedida ou não haja outros tipos de membro para analisar. Se a análise não for bem-sucedida, uma exceção será gerada.

Aplica-se a

ParseValue(String, XmlNameTable, XmlNamespaceManager)

Quando substituído em uma classe derivada, valida a cadeia de caracteres especificada em relação a um tipo simples interno ou definido pelo usuário.

public:
 abstract System::Object ^ ParseValue(System::String ^ s, System::Xml::XmlNameTable ^ nameTable, System::Xml::XmlNamespaceManager ^ nsmgr);
public abstract object ParseValue(string s, System.Xml.XmlNameTable nameTable, System.Xml.XmlNamespaceManager nsmgr);
abstract member ParseValue : string * System.Xml.XmlNameTable * System.Xml.XmlNamespaceManager -> obj
Public MustOverride Function ParseValue (s As String, nameTable As XmlNameTable, nsmgr As XmlNamespaceManager) As Object

Parâmetros

s
String

A cadeia de caracteres a ser validada em relação ao tipo simples.

nameTable
XmlNameTable

O XmlNameTable a ser usado para atomização ao analisar a cadeia de caracteres se esse XmlSchemaDatatype objeto representar o tipo xs:NCName.

nsmgr
XmlNamespaceManager

O XmlNamespaceManager objeto a ser usado ao analisar a cadeia de caracteres se esse XmlSchemaDatatype objeto representar o tipo xs:QName.

Retornos

Um Object que pode ser convertido com segurança no tipo retornado pela ValueType propriedade.

Exceções

O valor de entrada não é uma instância válida desse tipo de esquema XML W3C.

O valor a ser analisado não pode ser nulo (Nothing no Visual Basic).

Comentários

O ParseValue método valida a cadeia de caracteres especificada em relação a um tipo simples interno ou definido pelo usuário. Por exemplo, se isso XmlSchemaDatatype representar o tipo xs:date, uma instância será DateTime retornada.

Veja a seguir as etapas executadas durante o ParseValue processo de validação do método.

  1. Converta a cadeia de caracteres especificada em seu tipo CLR (Common Language Runtime) correspondente.

  2. Verifique se o valor não viola nenhuma faceta definida para o tipo simples.

Em seguida, o valor convertido é retornado como um Object e pode ser convertido com segurança para o tipo que é retornado pela ValueType propriedade.

Quando o XmlSchemaDatatype objeto representa um tipo de lista, o valor da cadeia de caracteres de entrada é convertido em uma lista de um ou mais objetos. Quando o XmlSchemaDatatype objeto representa um tipo de lista, é feita uma tentativa de analisar o valor de entrada como um tipo de membro da união. Se a tentativa de análise falhar, a conversão será tentada com o próximo membro da união até que a análise seja bem-sucedida ou não haja outros tipos de membro para analisar. Se a análise não for bem-sucedida, uma exceção será gerada.

Aplica-se a