IntelliSense XML no Visual Basic

  • Artigo

O Editor de Códigos Visual Basic inclui recursos do IntelliSense para XML que fornecem completamento de palavras para os elementos definidos em um esquema XML.Se você incluir um arquivo XSD (XSD) no seu projeto e importar o namespace de destino do esquema usando a instrução Imports,o Editor de Códigos irá incluir elementos do esquema XSD na lista do IntelliSense das variáveis de membros válidos para XElement e objetos XDocument.A ilustração a seguir mostra a lista de membros do IntelliSense para um objeto XElement.

IntelliSense XML

Ativando XML IntelliSense em Visual Basic

Para permitir XML IntelliSense no Visual Basic, você deve incluir um arquivo de esquema XSD em seu projeto Visual Basic.Você também deve importar o namespace de destino para o esquema XSD para o arquivo de código usando a instrução Imports.Como alternativa, você pode adicionar o namespace de destino à lista de namespace de nível de projeto usando a página References do criador do projeto Visual Basic.Consulte Como: Habilitar o XML IntelliSense no Visual Basic para obter exemplos.Para obter mais informações, consulte Instrução Imports (Namespace XML) e Página de referências, Designer de projeto (Visual Basic).

Observe que por padrão você não consegue ver arquivos de esquema XSD em projetos Visual Basic.Talvez você precise clicar no botão Mostrar todos os arquivos para selecionar um arquivo XSD para incluir em seu projeto.

Gerando um arquivo de esquema (Schema inferência)

Você pode criar um esquema para um arquivo XML existente inferindo o esquema XSD usando as ferramentas de XML Visual Studio.

  • A partir do SP1, você pode usar o XML para esquema assistente para criar um conjunto de esquema XML que é inferido a partir de um ou mais documentos XML e incluí-lo em seu projeto.Você pode usar qualquer combinação de documentos XML em forma de arquivos de texto, XML de endereços de HTTP Internet ou XML que é digitado ou colado em XML a fim de Assistente de esquema.Para acessar o XML para o Assistente de esquema, clicar Adicionar novo item on the Projeto menu e adicione um XML to Schema modelo do ambos o Dados or Itens comunsagrupar de modelo .Depois que você incluiu todas as fontes de documento XML para inferir o esquema XML conjunto no, clicar OK para criar o esquema inferido conjunto.Para obter mais informações, consulte Assistente de esquema XML e Como: Criar um esquema XML conjunto usando o XML para o Assistente de esquema

  • Você também pode usar o Editor do Visual Studio XML para inferir um conjunto de esquema XSD de um arquivo XML.Para criar um esquema XML definido usando o Editor de XML, em em aberto um arquivo XML no Visual Studio XML Designer e, em seguida, clicar Criar esquema on the XML menu.Depois de criar o conjunto de esquema XSD, você pode salvar o conjunto de esquema criado em um ou mais arquivos XSD e incluí-las em seu projeto.Para obter mais informações, consulte Como: Habilitar o XML IntelliSense no Visual Basic.

Observe que diferentes conjuntos de esquema XSD podem ser deduzidos a partir de vários documentos XML que devem ter o mesmo esquema.Isso pode ocorrer quando determinados elementos e atributos são encontrados em um arquivo XML e não no outro, ou quando os elementos são incluídos em ordem diferente, por exemplo.Você deve analisar conjuntos de esquema XSD inferidos para integridade e a precisão quando você usa a inferência de esquema XSD.

Membro de lista

Após você digitar um ponto (.) para delimitar uma instância de um objeto XElement ou XDocument (ou uma instância de IEnumerable(Of XElement) ou IEnumerable(Of XDocument)), o Visual Basic IntelliSense exibe uma lista de possíveis membros do objeto.A lista inicial inclui três opções que representam propriedades do eixo XML, conforme descrito na lista a seguir.

Selecione ou começe a digitar qualquer uma das opções da lista de XML.A lista de membros, em seguida, exibirá possíveis membros do esquema XML que são específicos para a opção selecionada.Se você tiver namespace XML importados que estão associados com um específico prefixo de namespace XML, uma lista de possíveis prefixos de namespace XML está incluída na lista de membros.

Por exemplo, considere o seguinte esquema XSD.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" 
           elementFormDefault="qualified" 
           targetNamespace="http://SamplePurchaseOrder" 
           xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="PurchaseOrders">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="PurchaseOrder">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Address" />
              <xs:element name="Items" />
              <xs:element name="Comment" />
            </xs:sequence>
            <xs:attribute name="PurchaseOrderNumber" type="xs:unsignedShort" use="required" />
            <xs:attribute name="OrderDate" type="xs:string" use="required" />
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

XML válido para o esquema XSD seria semelhante ao seguinte:

<?xml version="1.0"?>
<PurchaseOrders xmlns="http://SamplePurchaseOrder">
  <PurchaseOrder PurchaseOrderNumber="12345" OrderDate="2000-1-1">
    <Address />
    <Items />
    <Comment />
  </PurchaseOrder>
</PurchaseOrders>

Se você incluir esse arquivo de esquema XSD em um projeto e importar o namespace de destino do esquema XSD para seu arquivo de código ou projeto, o Visual Basic IntelliSense exibe membros do esquema conforme você digita seu código Visual Basic.Se o namespace de destino para o esquema XSD é importado como o namespace padrão e você digitar o seguinte, o IntelliSense exibe uma lista dos elementos filho possíveis para o elemento XML PurchaseOrder

Dim po = <PurchaseOrder />
po.<

A lista consiste nos elementos de endereço, comentário e itens.

Níveis de certeza para itens da lista do IntelliSense

Determinar o tipo XSD para usar no IntelliSense não é exato.Como resultado, o XML IntelliSense geralmente mostrará uma lista expandida de membros possíveis.Para ajudar você a selecionar um item da lista de membros do IntelliSense, os itens são exibidos com uma indicação do nível de certeza que o XML IntelliSense tem para um determinado membro.

Às vezes, XML IntelliSense pode identificar um tipo específico do esquema XSD.Nesses casos, ela exibirá possíveis elementos filho, atributos ou elementos descendentes para aquele tipo XSD com um alto grau de certeza.Esses itens são identificados com uma marca de seleção.

No entanto, às vezes, o XML IntelliSense não é capaz identificar um tipo específico do esquema XSD.Nesses casos, ele exibirá um lista expandida de possíveis elementos filho, atributos ou descendentes do esquema XSD para o projeto com um baixo grau de certeza.Esses itens são identificados com uma interrogação.

Consulte também

Tarefas

Como: Habilitar o XML IntelliSense no Visual Basic

Como: Criar um esquema XML conjunto usando o XML para o Assistente de esquema

Referência

Assistente de esquema XML

Instrução Imports (Namespace XML)

Elemento Literal XML

Propriedade Axis de atributo XML

Propriedade de Eixo Descendente XML

Página de referências, Designer de projeto (Visual Basic)

Date

History

Motivo

Julho de 2008

Conteúdo adicionado em relação ao novo XML Schema Assistente para a seção "Gerando um arquivo do esquema (Schema inferência)".

Alteração de recurso do SP1.