Método IVsDataProvider.GetProperty

Artigo
10/26/2012

Obtém uma propriedade registrada do provedor de DDEX.

Namespace: Microsoft.VisualStudio.Data.Core
Assembly: Microsoft.VisualStudio.Data.Core (em Microsoft.VisualStudio.Data.Core.dll)

Sintaxe

'Declaração
Function GetProperty ( _
    name As String _
) As Object

Object GetProperty(
    string name
)

Object^ GetProperty(
    String^ name
)

abstract GetProperty : 
        name:string -> Object

function GetProperty(
    name : String
) : Object

Parâmetros

name
Tipo: System.String
O nome da propriedade para recuperar.

Valor de retorno

Tipo: System.Object
O valor da propriedade, se existir; caso contrário, nulluma referência nula (Nothing no Visual Basic).

Exceções

Exceção	Condição
ArgumentNullException	o parâmetro de name é nulluma referência nula (Nothing no Visual Basic).

Comentários

Um provedor de DDEX pode registrar um conjunto de propriedades que os clientes de DDEX podem acessar para determinar informações sobre o provedor.As propriedades padrão incluem o nome do provedor, o nome para exibição, o nome para exibição curto, descrição, e a tecnologia, mas qualquer propriedade pode ser incluída pelo provedor.

Um valor de propriedade é recuperado abrindo a chave de Registro da raiz do provedor de DDEX e solicitando um valor sob a chave que tem o nome especificado.(A chave de Registro de origem está localizada sob a chave de DataProviders seção no local de Registro do Visual Studio.) Depois que uma propriedade específica for solicitada, o valor é salvo na memória em tempo de execução de DDEX e não atualizado até que o Visual Studio é reiniciado.

Exemplos

O código a seguir demonstra como recuperar o valor da propriedade de InvariantName , que é geralmente definida pelos provedores de DDEX que são baseados na tecnologia do ADO.NET.O valor de essa propriedade é então usado para criar um objeto de conexão ADO.NET por APIs de DbProviderFactory.

using System;
using System.Data;
using System.Data.Common;
using Microsoft.VisualStudio.Data.Core;

public class DDEX_IVsDataProviderExample4
{
    public static DbConnection CreateAdoDotNetConnection(
        IVsDataProvider provider)
    {
        string invariantName = provider.GetProperty("InvariantName") as string;
        if (invariantName != null)
        {
            DbProviderFactory factory = DbProviderFactories.GetFactory(
                invariantName);
            if (factory != null)
            {
                return factory.CreateConnection();
            }
        }
        return null;
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

IVsDataProvider Interface

Namespace Microsoft.VisualStudio.Data.Core

Partilhar via