Compartilhar via


Cache de esquema

O editor XML fornece um cache de esquema localizado no diretório%VSInstallDir%\xml\Schemas . O cache de esquema é global para todos os usuários em seu computador e inclui esquemas XML padrão que são usados para validação de documentos IntelliSense e XML.

O editor XML também pode encontrar esquemas localizados na solução, esquemas especificados no campo Esquemas da janela Propriedades do documento e esquemas identificados por atributos xsi:schemaLocation e xsi:noNamespaceSchemaLocation .

A tabela a seguir descreve os esquemas instalados com o editor XML.

Nome do Arquivo Description
catalog.xsd Esquema para arquivos de catálogo do editor de XML. Para obter informações sobre catálogos de esquemas, consulte abaixo.
DotNetConfig.xsd Esquema para arquivos Web.Config, http://schemas.microsoft.com/.NETConfiguration/v2.0.
msbuild.xsd Esquema para o MSBuild criar arquivos, http://schemas.microsoft.com/developer/msbuild/2003.
msdata.xsd Esquema para as anotações XSD adicionadas pela classe DataSet, "urn:schemas-microsoft-com:xml-msdata".
msxsl.xsd Esquema para extensões de bloco de script XSLT da Microsoft, urn:schemas-microsoft-com:xslt.
SnippetFormat.xsd Esquema para os arquivos XML de trechos de código. Para obter exemplos, consulte %VSInstallDir%\VC#\Expansions.
Soap1.1.xsd Esquema para SOAP (Simple Object Access Protocol) 1.1, http://schemas.xmlsoap.org/soap/envelope/.
Soap1.2.xsd Esquema do Protocolo de Acesso a Objetos Simples 1.2.
SiteMapSchema.xsd Esquema para arquivo XML de mapa de site do ASP.NET, http://schemas.microsoft.com/AspNet/SiteMap-File-1.0.
wsdl.xsd Esquema para linguagem de descrição do serviço Web. http://schemas.xmlsoap.org/wsdl/
xenc.xsd Esquema para criptografia XML. http://www.w3.org/2000/09/xmldsig#
xhtml.xsd Esquema para XHTML http://www.w3.org/1999/xhtml.
xlink.xsd Esquema para XLink1.0, http://www.w3.org/1999/xlink.
xml.xsd Esquema que descreve atributos xml:space e xml:lang. http://www.w3.org/XML/1998/namespace
xmlsig.xsd Esquema para assinaturas digitais XML. http://www.w3.org/2000/09/xmldsig#
xsdschema.xsd Esquema que descreve o próprio XSD. http://www.w3.org/2001/XMLSchema
xslt.xsd Esquema para transformações XML. http://www.w3.org/1999/XSL/Transform

Atualizar esquemas no cache

O editor carrega o diretório de cache de esquema quando o pacote do editor XML é carregado e observa as alterações durante a execução. Se um esquema tiver sido adicionado, ele será carregado automaticamente em um índice na memória de esquemas conhecidos. Se um esquema tiver sido removido, ele será removido automaticamente do índice na memória. Se um esquema tiver sido atualizado, ele invalida automaticamente o cache na memória desse esquema.

Observação

Como o diretório de cache de esquema é global para seu computador, você só deve adicionar esquemas aqui padrão e úteis a todos os projetos do Visual Studio que podem ser criados em seu computador.

O editor XML também dá suporte a qualquer número de arquivos de catálogo de esquemas no diretório de cache de esquema. Catálogos de esquemas podem apontar para outros locais para esquemas que você sempre deseja que o editor saiba. O arquivo catalog.xsd define o formato do arquivo de catálogo e está incluído no diretório de cache de esquema. O arquivo catalog.xml é o catálogo padrão e contém links para outros esquemas no %VSInstallDir%. Veja a seguir uma amostragem do arquivo catalog.xml :

<SchemaCatalog xmlns="http://schemas.microsoft.com/xsd/catalog">
  <Schema href="%VSInstallDir%/help/schemas/Favorites.xsd" targetNamespace="urn:Favorites-Schema"/>
  <Schema href="%VSInstallDir%/help/schemas/Links.xsd" targetNamespace="urn:Links-Schema"/>
  <Schema href="%VSInstallDir%/help/schemas/MyHelp.xsd" targetNamespace="urn:VSHelp-Schema"/>
</SchemaCatalog>

O href atributo pode ser qualquer caminho de arquivo ou URL http apontando para o esquema. O caminho do arquivo pode ser relativo ao documento de catálogo. As seguintes variáveis, delimitadas por %%, são reconhecidas pelo editor e expandidas no caminho:

  • VSInstallDir

  • System

  • ProgramFiles

  • Programas

  • CommonProgramFiles

  • DadosDeAplicativo

  • DadosDeAplicaçãoComum

  • LCID

O documento de catálogo pode incluir um Catalog elemento, que aponta para outros catálogos. Você pode usar o Catalog elemento para apontar para um catálogo central compartilhado por sua equipe ou empresa ou um catálogo online compartilhado com seus parceiros de negócios. O href atributo é o caminho do arquivo ou a URL http para os outros catálogos. Veja a seguir um exemplo do Catalog elemento:

<Catalog href="file://c:/xcbl/xcblCatalog.xml"/>

O catálogo também pode controlar como os esquemas são associados a documentos XML usando o elemento especial Association . Esse elemento associa esquemas que não têm namespace de destino a uma extensão de arquivo específica, o que pode ser útil porque o editor XML não faz nenhuma associação automática de esquemas que não têm um targetNamespace atributo. No exemplo a seguir, o Association elemento associa o esquema dotNetConfig a todos os arquivos que têm a extensão de arquivo "config":

<Association extension="config" schema="%VSInstallDir%/xml/schemas/dotNetConfig.xsd"/>

Esquemas localizados

Em muitos casos, o arquivo catalog.xml não contém entradas para esquemas localizados. Você pode adicionar entradas adicionais ao arquivo catalog.xml que apontam para o diretório de esquema localizado.

No exemplo a seguir, foi criado um novo Schema elemento que usa a variável %LCID% para apontar para o esquema localizado.

<Schema href="%InstallRoot%/Common7/IDE/Policy/Schemas/%LCID%/TDLSchema.xsd"
  targetNamespace="http://www.microsoft.com/schema/EnterpriseTemplates/TDLSchema"/>

Alterar o local do cache de esquema

Você pode personalizar o local para o cache de esquema usando a página de opções Diversos. Se você tiver um diretório de esquemas favoritos, o editor poderá ser configurado para usar esses esquemas.

Observação

Essa alteração afeta apenas o usuário atual do Visual Studio.

Para alterar o local do cache de esquema

  1. No menu Ferramentas , selecione Opções.

  2. Expanda o Editor de Texto, expanda XML e clique em Diversos.

  3. Clique no botão Procurar no campo Esquemas .

  4. Selecione a pasta do cache de esquema e clique em OK.

Para adicionar outro diretório de esquemas comuns

  1. Edite o arquivo catalog.xml no diretório de cache do esquema do editor XML.

  2. Adicione um novo <Catalog href="..."/> elemento que aponta para o diretório de esquemas adicionais.

  3. Salve suas alterações.

    O catálogo é recarregado automaticamente.