Compartilhar via


Visão geral do Microsoft Data Shaping Service para OLE DB

Importante

Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, os aplicativos devem usar XML.

O Microsoft Data Shaping Service para o provedor de serviço OLE DB dá suporte à construção de objetos Recordset hierárquicos (com essa forma) de um provedor de dados.

Palavra-chave do provedor

Para invocar o Data Shaping Service para OLE DB, especifique a palavra-chave e o valor a seguir na cadeia de conexão.

"Provider=MSDataShape"

Propriedades Dinâmicas

Quando esse provedor de serviços é invocado, as propriedades dinâmicas apresentadas a seguir são adicionadas à coleção Propriedades do objeto Connection.

Nome de propriedades dinâmicas Descrição
Nomes exclusivos de remodelação Indica se objetos Recordset com valores duplicados para suas propriedades Reshape Name são permitidos. Se essa propriedade dinâmica for True e um novo Recordset for criado com o mesmo nome de remodelação especificado pelo usuário de um Recordset existente, o nome de remodelação do novo objeto Recordset será modificado para torná-lo exclusivo. Se essa propriedade for False e um novo Recordset for criado com o mesmo nome de remodelação especificado pelo usuário que o Recordset existente, ambos os objetos Recordset terão o mesmo nome de remodelação. Portanto, nenhum Recordset pode ser remodelado enquanto ambos os conjuntos de registros existirem.

O valor padrão da propriedade é False.
Provedor de Dados Indica o nome do provedor que fornecerá linhas a serem formadas. Esse valor poderá ser NONE se um provedor não for usado para fornecer linhas.

Você pode definir propriedades dinâmicas graváveis especificando seus nomes como palavras-chave na cadeia de conexão. Por exemplo, no Microsoft Visual Basic, defina a propriedade dinâmica Data Provider como "MSDASQL" especificando:

Dim cn as New ADODB.Connection
cn.Open "Provider=MSDataShape;Data Provider=MSDASQL"

Você também pode definir ou recuperar uma propriedade dinâmica especificando seu nome como o índice para a propriedade Properties. Por exemplo, o exemplo de código a seguir obtém e imprime o valor atual da propriedade dinâmica Data Provider e define um novo valor se cn.DataProvider foi definido como "MSDataShape" (direta ou indiretamente por meio da cadeia de conexão) e a conexão não foi aberta:

Debug.Print cn.Properties("Data Provider")
cn.Properties("Data Provider") = "MSDASQL"

Observação

A propriedade dinâmica, Data Provider, só pode ser definida em um objeto Connection não aberto. Depois que a conexão é aberta, a propriedade Data Provider se torna somente leitura.

Para saber mais sobre a formatação de dados, confira Data Shaping.

Confira também

Apêndice A: Provedores