IntelliSense XML no Visual Basic

Artigo
02/25/2013

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 de definição de esquema XML (XSD) em seu projeto e importar o namespace de destino do esquema usando o Imports instrução, o Editor de códigos incluirá os elementos do esquema XSD na lista de variáveis de membro válido para IntelliSense XElement e XDocument objetos.A ilustração a seguir mostra a lista de membros do IntelliSense para um objeto XElement.

IntelliSense XML

XML IntelliSense em Visual Basic

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: ativar XML IntelliSense em Visual Basic para obter exemplos.Para obter mais informações, consulte Declaração Imports (Namespace XML) e Referências de página, 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 (inferência do esquema)

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

Começando no SP1, você pode usar o Assistente de esquema XML 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 na forma de arquivos de texto, XML de endereços de HTTP Internet ou XML que é digitado ou colado no Assistente de esquema XML.Para acessar o XML para o Assistente de esquema, clique Add New Item na projeto menu e adicione um XML para esquema modelo a partir de um a dados ou Itens comuns grupo de modelo.Depois que você incluiu todas as fontes de documento XML para inferir o conjunto de esquema XML do, clique em OK para criar o esquema inferido conjunto.Para obter mais informações, consulte XML para o Assistente de esquema (Visual Basic).
Você também pode usar o Editor de XML Visual Studio inferir um conjunto de esquema XSD de um arquivo XML.Para criar um esquema XML definido usando o Editor de XML, abrir um arquivo XML no XML Designer Visual Studio e, em seguida, clique em Create Schema sobre o 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í-los em seu projeto.Para obter mais informações, consulteComo: ativar XML IntelliSense em Visual Basic.

Observe que os 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 examinar os conjuntos de esquema XSD inferidos abrangência 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.

Opção	Descrição
< >	Selecione esta opção para mostrar uma lista de possíveis elementos filhos.Para obter mais informações, consulte Literal do elemento XML (Visual Basic) e o método Elements.
@	Selecione esta opção para mostrar uma lista de possíveis atributos.Para obter mais informações, consulte Propriedades de eixo XML (Visual Basic). Esta opção está disponível somente para objetos do tipo XElement.
… < >	Selecione esta opção para mostrar uma lista de possíveis elementos descendentes.Para obter mais informações, consulte Como: elementos de descendente XML do Access (Visual Basic) e o método Elements.

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.