Partilhar via


Cache de esquema

O editor XML fornece um cache de esquema localizado no diretório \xml\Schemas da%VSInstallDir% . O cache de esquema é global para todos os usuários no computador e inclui esquemas XML padrã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 de Propriedades do documento, e esquemas identificados pelos atributos xsi:schemaLocation e xsi:noNamespaceSchemaLocation.

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

Nome do ficheiro Description
catálogo.xsd Esquema para ficheiros de catálogo de esquemas do editor XML. Para obter informações sobre catálogos de esquema, veja abaixo.
DotNetConfig.xsd Esquema para arquivos Web.Config, http://schemas.microsoft.com/.NETConfiguration/v2.0.
msbuild.xsd Esquema para o MSBuild make files, 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 Microsoft XSLT, urn:schemas-microsoft-com:xslt.
SnippetFormat.xsd Esquema para os ficheiros 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 para Protocolo Simples de Acesso a Objetos 1.2.
SiteMapSchema.xsd Esquema para ficheiro XML de mapa do site do ASP.NET, http://schemas.microsoft.com/AspNet/SiteMap-File-1.0.
wsdl.xsd Esquema para a 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 os 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 todas as alterações durante a execução. Se um esquema tiver sido adicionado, ele será automaticamente carregado 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 invalidará automaticamente o cache na memória desse esquema.

Observação

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

O editor XML também suporta qualquer número de ficheiros de catálogo de esquema no diretório de cache do esquema. Os catálogos de esquema podem apontar para outros locais para esquemas que você sempre deseja que o editor conheça. O arquivo catalog.xsd define o formato para o 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%. Segue-se uma amostra do ficheiro 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 do catálogo. As seguintes variáveis, delimitadas por %%, são reconhecidas pelo editor e expandidas no caminho:

  • VSInstallDir

  • System

  • Ficheiros de Programas

  • Programas

  • CommonProgramFiles

  • ApplicationData

  • CommonApplicationData

  • 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 URL http para os outros catálogos. Segue-se 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 apontem 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 Opções diversas . Se você tiver um diretório de esquemas favoritos, o editor pode ser configurado para usar esses esquemas.

Observação

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

Para alterar a localização do cache de esquema

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

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

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

  4. Selecione a pasta para o 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 aponte para o diretório de esquemas adicionais.

  3. Salve suas alterações.

    O catálogo é recarregado automaticamente.