XmlSchemaDatatype.ParseValue Método

Referência

Definição

Namespace:: System.Xml.Schema

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

ParseValue(String, XmlNameTable, IXmlNamespaceResolver)	Quando substituído em uma classe derivada, valida a `string` especificada 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)

Quando substituído em uma classe derivada, valida a string 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::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 a ser validada em relação ao tipo simples.

nameTable: XmlNameTable

A XmlNameTable a ser usada para atomização ao analisar a string se este objeto XmlSchemaDatatype representar o tipo xs:NCName.

nsmgr: IXmlNamespaceResolver

O objeto IXmlNamespaceResolver que será usado durante a análise de string se este XmlSchemaDatatype objeto representar o tipo xs:QName.

Retornos

Object

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

Exceções

XmlSchemaValidationException

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

ArgumentNullException

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 <mscorlib.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
using namespace System::Xml::Schema;

class XmlSchemaExamples
{
public:

    static void Main()
    {
        XmlTextReader^ xtr = gcnew XmlTextReader("example.xsd");
        XmlSchema^ schema = XmlSchema::Read(xtr, gcnew ValidationEventHandler(ValidationCallbackOne));

        XmlSchemaSet^ schemaSet = gcnew XmlSchemaSet();
        schemaSet->ValidationEventHandler += gcnew ValidationEventHandler(ValidationCallbackOne);
        schemaSet->Add(schema);
        schemaSet->Compile();

        XmlSchema^ compiledSchema;

        for each (XmlSchema^ schema1 in schemaSet->Schemas())
        {
            compiledSchema = schema1;
        }

        for each (XmlSchemaObject^ schemaObject in compiledSchema->Items)
        {
            if (schemaObject->GetType() == XmlSchemaSimpleType::typeid)
            {
                XmlSchemaSimpleType^ simpleType = dynamic_cast<XmlSchemaSimpleType^>(schemaObject);
                Console::WriteLine("{0} {1}", simpleType->Name, simpleType->Datatype->ValueType);
            }
            if (schemaObject->GetType() == XmlSchemaComplexType::typeid)
            {
                XmlSchemaComplexType^ complexType = dynamic_cast<XmlSchemaComplexType^>(schemaObject);
                Console::WriteLine("{0} {1}", complexType->Name, complexType->Datatype->ValueType);
            }
        }
        xtr->Close();
    }

    static void ValidationCallbackOne(Object^ sender, ValidationEventArgs^ args)
    {
        Console::WriteLine(args->Message);
    }
};

int main()
{
    XmlSchemaExamples::Main();
    return 0;
};

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.

Converta o valor especificado como um string para seu tipo CLR (Common Language Runtime) correspondente.
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á lançada.

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

A XmlNameTable a ser usada para atomização ao analisar a cadeia de caracteres se este objeto XmlSchemaDatatype representar o tipo xs:NCName.

nsmgr: XmlNamespaceManager

O objeto XmlNamespaceManager que será usado durante a análise da cadeia de caracteres se este objeto XmlSchemaDatatype representar o tipo xs:QName.

Retornos

Object

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

Exceções

XmlSchemaValidationException

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

ArgumentNullException

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.

Converta a cadeia de caracteres especificada em seu tipo CLR (Common Language Runtime) correspondente.
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á lançada.

Aplica-se a

Partilhar via

XmlSchemaDatatype.ParseValue Método

Definição

Sobrecargas

ParseValue(String, XmlNameTable, IXmlNamespaceResolver)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

ParseValue(String, XmlNameTable, XmlNamespaceManager)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Recursos adicionais