Metodo IVsDataProvider.GetProperty

Ottiene una proprietà registrata provider di DDEX.

Spazio dei nomi:  Microsoft.VisualStudio.Data.Core
Assembly:  Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)

Sintassi

'Dichiarazione
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

Parametri

• name
  Tipo: String

  Nome della proprietà da recuperare.

Valore restituito

Tipo: Object
Il valore della proprietà, se disponibile; in caso contrario, nullriferimento null (Nothing in Visual Basic).

Eccezioni

Eccezione	Condizione
ArgumentNullException	Il parametro name è nullriferimento null (Nothing in Visual Basic).

Note

Un provider di DDEX può registrare un set di proprietà che i client di DDEX possono accedere per ottenere informazioni sul provider. Le proprietà standard includono il nome del provider, il nome visualizzato, il nome breve visualizzato, la descrizione e la tecnologia, ma la proprietà può essere inclusa dal provider.

Un valore della proprietà viene recuperato dalla chiave del Registro di sistema radice del provider di DDEX e richiedendo un valore nella chiave con il nome specificato. (La chiave del Registro di sistema radice è presente nel DataProviders digitare gli hive del Registro di sistema locale di Visual Studio.) Dopo che una determinata proprietà è stata richiesta, il valore viene salvato in memoria dal runtime di DDEX e non viene aggiornato fino a riavviare Visual Studio.

Esempi

Il codice seguente viene illustrato come recuperare il valore della proprietà InvariantName, che in genere è definita dai provider di DDEX basati sulla tecnologia ADO.NET. Il valore di questa proprietà viene quindi utilizzato per creare un oggetto connessione ADO.NET mediante le API di 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;
    }
}

Sicurezza di .NET Framework

• Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

IVsDataProvider Interfaccia

Spazio dei nomi Microsoft.VisualStudio.Data.Core