XmlSchemaCollection.Add Método

Definição

Namespace:

System.Xml.Schema

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Adiciona o esquema determinado à coleção de esquemas.

Sobrecargas

Nome	Description
Add(XmlSchema)	Adiciona a XmlSchema coleção.
Add(XmlSchemaCollection)	Adiciona todos os namespaces definidos na coleção determinada (incluindo seus esquemas associados) a essa coleção.
Add(String, String)	Adiciona o esquema localizado pela URL fornecida à coleção de esquemas.
Add(String, XmlReader)	Adiciona o esquema contido na XmlReader coleção de esquemas.
Add(XmlSchema, XmlResolver)	Adiciona a XmlSchema coleção. O especificado XmlResolver é usado para resolver quaisquer referências externas.
Add(String, XmlReader, XmlResolver)	Adiciona o esquema contido na XmlReader coleção de esquemas. O especificado XmlResolver é usado para resolver todos os recursos externos.

Comentários

Importante

A XmlSchemaCollection classe está obsoleta no .NET Framework versão 2.0 e foi substituída pela XmlSchemaSet classe.

Add(XmlSchema)

Origem:

XmlSchemaCollection.cs

Adiciona a XmlSchema coleção.

public:
 System::Xml::Schema::XmlSchema ^ Add(System::Xml::Schema::XmlSchema ^ schema);

public System.Xml.Schema.XmlSchema? Add(System.Xml.Schema.XmlSchema schema);

member this.Add : System.Xml.Schema.XmlSchema -> System.Xml.Schema.XmlSchema

Public Function Add (schema As XmlSchema) As XmlSchema

Parâmetros

schema

XmlSchema

O XmlSchema para adicionar à coleção.

Retornos

XmlSchema

O objeto XmlSchema.

Comentários

O targetNamespace atributo é usado para identificar esse esquema.

Se o esquema que está sendo adicionado contiver referências a outros namespaces (por meio include e import elementos), o nível de confiança do aplicativo determinará como esses outros namespaces são resolvidos. (No .NET Framework versão 1.0, um padrão XmlUrlResolver sempre foi usado).

Fully trusted code: Um padrão XmlUrlResolver sem credenciais de usuário é usado para resolver quaisquer recursos externos. Os esquemas para esses outros namespaces são carregados apenas para fins de validação. Ao contrário do esquema original, esses outros esquemas não são adicionados explicitamente à coleção de esquemas. Como resultado, eles não são acessíveis usando nenhum dos métodos ou propriedades da coleção. Se esses recursos externos estiverem localizados em um recurso de rede que exija autenticação, use uma sobrecarga que usa um XmlResolver como um de seus argumentos e especifique um XmlResolver com as credenciais necessárias.

Semi-trusted code: As referências externas não são resolvidas.

Observação

Se estiver XmlSchemaCollection sendo acessado usando a XmlValidatingReader.Schemas propriedade, o Add método usará o XmlResolver especificado pela XmlValidatingReader.XmlResolver propriedade.

Importante

A XmlSchemaCollection classe está obsoleta no .NET Framework versão 2.0 e foi substituída pela XmlSchemaSet classe.

Confira também

• XmlSchema

Add(XmlSchemaCollection)

Origem:

XmlSchemaCollection.cs

Adiciona todos os namespaces definidos na coleção determinada (incluindo seus esquemas associados) a essa coleção.

public:
 void Add(System::Xml::Schema::XmlSchemaCollection ^ schema);

public void Add(System.Xml.Schema.XmlSchemaCollection schema);

member this.Add : System.Xml.Schema.XmlSchemaCollection -> unit

Public Sub Add (schema As XmlSchemaCollection)

Parâmetros

schema

XmlSchemaCollection

O XmlSchemaCollection que você deseja adicionar a esta coleção.

Comentários

Se o esquema que está sendo adicionado contiver referências a outros namespaces (por meio include e import elementos ou atributo x-schema ), o nível de confiança do aplicativo determinará como esses outros namespaces são resolvidos. (No .NET Framework versão 1.0, um padrão XmlUrlResolver sempre foi usado).

Fully trusted code: Um padrão XmlUrlResolver sem credenciais de usuário é usado para resolver quaisquer recursos externos. Os esquemas para esses outros namespaces são carregados apenas para fins de validação. Ao contrário do esquema original, esses outros esquemas não são adicionados explicitamente à coleção de esquemas. Como resultado, eles não são acessíveis usando nenhum dos métodos ou propriedades da coleção. Se esses recursos externos estiverem localizados em um recurso de rede que exija autenticação, use uma sobrecarga que usa um XmlResolver como um de seus argumentos e especifique um XmlResolver com as credenciais necessárias.

Semi-trusted code: As referências externas não são resolvidas.

Observação

Se estiver XmlSchemaCollection sendo acessado usando a XmlValidatingReader.Schemas propriedade, o Add método usará o XmlResolver especificado pela XmlValidatingReader.XmlResolver propriedade.

Importante

A XmlSchemaCollection classe está obsoleta no .NET Framework versão 2.0 e foi substituída pela XmlSchemaSet classe.

Add(String, String)

Origem:

XmlSchemaCollection.cs

Adiciona o esquema localizado pela URL fornecida à coleção de esquemas.

public:
 System::Xml::Schema::XmlSchema ^ Add(System::String ^ ns, System::String ^ uri);

public System.Xml.Schema.XmlSchema? Add(string? ns, string uri);

member this.Add : string * string -> System.Xml.Schema.XmlSchema

Public Function Add (ns As String, uri As String) As XmlSchema

Parâmetros

ns

String

O URI do namespace associado ao esquema. Para esquemas XML, esse normalmente será o targetNamespace.

uri

String

A URL que especifica o esquema a ser carregado.

Retornos

XmlSchema

O XmlSchema adicionado à coleção de esquemas; null se o esquema que está sendo adicionado for um esquema XDR ou se houver erros de compilação no esquema.

Exceções

XmlException

O esquema não é um esquema válido.

Comentários

Se ns já tiver sido associado a outro esquema na coleção, o esquema que está sendo adicionado substituirá o esquema original na coleção. Por exemplo, no código C# a seguir, authors.xsd é removido da coleção e names.xsd é adicionado.

schemaColl.Add("urn:author", "authors.xsd");
schemaColl.Add("urn:author", "names.xsd");

Se ns estiver null e o esquema que está sendo adicionado for um esquema XML, o Add método usará o targetNamespace definido no esquema XML para identificar o esquema na coleção. Se o esquema que está sendo adicionado contiver referências a outros namespaces (por meio include e import elementos ou atributo x-schema ), o nível de confiança do aplicativo determinará como esses outros namespaces são resolvidos. (No .NET Framework versão 1.0, um padrão XmlUrlResolver sempre foi usado).

Fully trusted code: Um padrão XmlUrlResolver sem credenciais de usuário é usado para resolver quaisquer recursos externos. Os esquemas para esses outros namespaces são carregados apenas para fins de validação. Ao contrário do esquema original, esses outros esquemas não são adicionados explicitamente à coleção de esquemas. Como resultado, eles não são acessíveis usando nenhum dos métodos ou propriedades da coleção. Se esses recursos externos estiverem localizados em um recurso de rede que exija autenticação, use uma sobrecarga que usa um XmlResolver como um de seus argumentos e especifique um XmlResolver com as credenciais necessárias.

Semi-trusted code: As referências externas não são resolvidas.

Observação

Se estiver XmlSchemaCollection sendo acessado usando a XmlValidatingReader.Schemas propriedade, o Add método usará o XmlResolver especificado pela XmlValidatingReader.XmlResolver propriedade.

Importante

A XmlSchemaCollection classe está obsoleta no .NET Framework versão 2.0 e foi substituída pela XmlSchemaSet classe.

Add(String, XmlReader)

Origem:

XmlSchemaCollection.cs

Adiciona o esquema contido na XmlReader coleção de esquemas.

public:
 System::Xml::Schema::XmlSchema ^ Add(System::String ^ ns, System::Xml::XmlReader ^ reader);

public System.Xml.Schema.XmlSchema? Add(string? ns, System.Xml.XmlReader reader);

member this.Add : string * System.Xml.XmlReader -> System.Xml.Schema.XmlSchema

Public Function Add (ns As String, reader As XmlReader) As XmlSchema

Parâmetros

ns

String

O URI do namespace associado ao esquema. Para esquemas XML, esse normalmente será o targetNamespace.

reader

XmlReader

XmlReader que contém o esquema a ser adicionado.

Retornos

XmlSchema

O XmlSchema adicionado à coleção de esquemas; null se o esquema que está sendo adicionado for um esquema XDR ou se houver erros de compilação no esquema.

Exceções

XmlException

O esquema não é um esquema válido.

Comentários

Se ns já tiver sido associado a outro esquema na coleção, o esquema que está sendo adicionado substituirá o esquema original na coleção.

Se ns estiver null e o esquema que está sendo adicionado for um esquema XML, o Add método usará o targetNamespace definido no esquema XML para identificar o esquema na coleção.

Se o esquema que está sendo adicionado contiver referências a outros namespaces (por meio include e import elementos ou atributo x-schema ), o nível de confiança do aplicativo determinará como esses outros namespaces são resolvidos. (No .NET Framework versão 1.0, um padrão XmlUrlResolver sempre foi usado).

Fully trusted code: Um padrão XmlUrlResolver sem credenciais de usuário é usado para resolver quaisquer recursos externos. Os esquemas para esses outros namespaces são carregados apenas para fins de validação. Ao contrário do esquema original, esses outros esquemas não são adicionados explicitamente à coleção de esquemas. Como resultado, eles não são acessíveis usando nenhum dos métodos ou propriedades da coleção. Se esses recursos externos estiverem localizados em um recurso de rede que exija autenticação, use uma sobrecarga que usa um XmlResolver como um de seus argumentos e especifique um XmlResolver com as credenciais necessárias.

Semi-trusted code: As referências externas não são resolvidas.

Observação

Se estiver XmlSchemaCollection sendo acessado usando a XmlValidatingReader.Schemas propriedade, o Add método usará o XmlResolver especificado pela XmlValidatingReader.XmlResolver propriedade.

Importante

A XmlSchemaCollection classe está obsoleta no .NET Framework versão 2.0 e foi substituída pela XmlSchemaSet classe.

Add(XmlSchema, XmlResolver)

Origem:

XmlSchemaCollection.cs

Adiciona a XmlSchema coleção. O especificado XmlResolver é usado para resolver quaisquer referências externas.

public:
 System::Xml::Schema::XmlSchema ^ Add(System::Xml::Schema::XmlSchema ^ schema, System::Xml::XmlResolver ^ resolver);

public System.Xml.Schema.XmlSchema? Add(System.Xml.Schema.XmlSchema schema, System.Xml.XmlResolver? resolver);

member this.Add : System.Xml.Schema.XmlSchema * System.Xml.XmlResolver -> System.Xml.Schema.XmlSchema

Public Function Add (schema As XmlSchema, resolver As XmlResolver) As XmlSchema

Parâmetros

schema

XmlSchema

O XmlSchema para adicionar à coleção.

resolver

XmlResolver

O XmlResolver usado para resolver namespaces referenciados e importinclude elementos. Se isso for null, as referências externas não serão resolvidas.

Retornos

XmlSchema

O XmlSchema adicionado à coleção de esquemas.

Exceções

XmlException

O esquema não é um esquema válido.

Comentários

O targetNamespace atributo é usado para identificar esse esquema.

Se o esquema contiver include e import elementos que fazem referência a outros namespaces, os esquemas para esses outros namespaces serão carregados somente para fins de validação. Ao contrário do esquema original, esses outros esquemas não são adicionados explicitamente à coleção de esquemas. Como resultado, eles não são acessíveis usando nenhum dos métodos ou propriedades da coleção.

Importante

A XmlSchemaCollection classe é obsoleta e foi substituída pela XmlSchemaSet classe.

Confira também

• Credentials
• NetworkCredential
• CredentialCache

Add(String, XmlReader, XmlResolver)

Origem:

XmlSchemaCollection.cs

Adiciona o esquema contido na XmlReader coleção de esquemas. O especificado XmlResolver é usado para resolver todos os recursos externos.

public:
 System::Xml::Schema::XmlSchema ^ Add(System::String ^ ns, System::Xml::XmlReader ^ reader, System::Xml::XmlResolver ^ resolver);

public System.Xml.Schema.XmlSchema? Add(string? ns, System.Xml.XmlReader reader, System.Xml.XmlResolver? resolver);

member this.Add : string * System.Xml.XmlReader * System.Xml.XmlResolver -> System.Xml.Schema.XmlSchema

Public Function Add (ns As String, reader As XmlReader, resolver As XmlResolver) As XmlSchema

Parâmetros

ns

String

O URI do namespace associado ao esquema. Para esquemas XML, esse normalmente será o targetNamespace.

reader

XmlReader

XmlReader que contém o esquema a ser adicionado.

resolver

XmlResolver

O XmlResolver usado para resolver namespaces referenciados e importinclude elementos ou x-schema atributos (esquemas XDR). Se isso for null, as referências externas não serão resolvidas.

Retornos

XmlSchema

O XmlSchema adicionado à coleção de esquemas; null se o esquema que está sendo adicionado for um esquema XDR ou se houver erros de compilação no esquema.

Exceções

XmlException

O esquema não é um esquema válido.

Comentários

Se ns já tiver sido associado a outro esquema na coleção, o esquema que está sendo adicionado substituirá o esquema original na coleção.

Se ns estiver null e o esquema que está sendo adicionado for um esquema XML, o Add método usará o targetNamespace atributo definido no esquema XML para identificar o esquema na coleção.

Se o esquema que está sendo adicionado contiver referências a outros namespaces (por meio include e import elementos ou x-schema atributo), os esquemas para esses outros namespaces serão carregados apenas para fins de validação. Ao contrário do esquema original, esses outros esquemas não são adicionados explicitamente à coleção de esquemas. Como resultado, eles não são acessíveis usando nenhum dos métodos ou propriedades da coleção.

Importante

A XmlSchemaCollection classe está obsoleta no .NET Framework versão 2.0 e foi substituída pela XmlSchemaSet classe.

Confira também

• Credentials
• NetworkCredential
• CredentialCache