IVsDataProvider.GetProperty – metoda

Článek
10/27/2012

Získá registrované vlastnost DDEX zprostředkovatele.

Obor názvů: Microsoft.VisualStudio.Data.Core
Sestavení: Microsoft.VisualStudio.Data.Core (v Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

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

Parametry

name
Typ: System.String
Název vlastnosti načíst.

Vrácená hodnota

Typ: System.Object
Hodnota vlastnosti, pokud existuje; jinak null .

Výjimky

Výjimka	Podmínka
ArgumentNullException	The name parameter is nullodkaz null (Nothing v jazyce Visual Basic).

Poznámky

DDEX zprostředkovatele můžete zaregistrovat sadu vlastností, které DDEX klientům přístup zjistit informace o zprostředkovateli.Standardní vlastnosti zahrnují název zprostředkovatele, zobrazované jméno, krátké zobrazovaný název, popis a technologie, ale mohou být zahrnuty všechny vlastnosti zprostředkovatelem.

Otevřením kořenový klíč registru zprostředkovatele DDEX a požadující hodnotu pod zadaným názvem klíče se načte hodnotu vlastnosti.(Kořenový klíč registru je umístěn v aplikaci Visual Studio místní podregistru v klíči DataProviders.) Po požadoval určitou vlastnost jeho hodnota je uložen v paměti runtime DDEX a není aktualizována až po restartování aplikace Visual Studio.

Příklady

Následující kód ukazuje, jak načíst hodnotu InvariantName vlastnost, která je obvykle definován DDEX zprostředkovatelů, které jsou založeny na technologii ADO.NET.Hodnota této vlastnosti je použito vytvořit objekt ADO.NET připojení prostřednictvím rozhraní API 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;
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

IVsDataProvider Rozhraní

Microsoft.VisualStudio.Data.Core – obor názvů

Sdílet prostřednictvím