Sdílet prostřednictvím

IVsDataSource.GetProperty – metoda (Guid, String)

  • Článek

Získá vlastnosti zdroje dat DDEX jako registrovaných specifické podpůrné DDEX provider.

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

Syntaxe

'Deklarace
Function GetProperty ( _
    provider As Guid, _
    name As String _
) As Object

Object GetProperty(
    Guid provider,
    string name
)

Object^ GetProperty(
    Guid provider, 
    String^ name
)

abstract GetProperty : 
        provider:Guid * 
        name:string -> Object 

function GetProperty(
    provider : Guid, 
    name : String
) : Object

Parametry

  • provider
    Typ: System.Guid
    Identifikátor podpůrné DDEX provider.

Vrácená hodnota

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

Výjimky

Výjimka Podmínka
ArgumentNullException

name Parametr byl null .

Poznámky

DDEX zdroje dat můžete zaregistrovat sadu vlastností, které jsou přístupné pro klienty DDEX zjistit informace o zdroji dat.Navíc každý DDEX zprostředkovatele podporujícího DDEX zdroje dat můžete zaregistrovat zprostředkovatele specifické vlastnosti spojené s DDEX zdroje dat.

Když provider parametr je prázdný identifikátor GUID, tato metoda načte hodnotu vlastnosti zdroje dat globální otevřením zdroje dat DDEX kořenový klíč registru (pod klíčem Sources podregistru Visual Studio místní) a požaduje hodnotu obsahující zadané v klíči name .Po zprostředkovatele parametr je platný identifikátor podpůrné zprostředkovatele DDEX, tato metoda načte hodnotu vlastnosti zprostředkovatele dat zdroje otevřít podklíč zprostředkovatele podpůrné zdroje dat kořenový klíč registru a hodnota v tomto podklíči zadaným žádostí name .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 provádění DisplayName vlastnost.Protože lokalizovaných řetězců jsou poskytovány pouze podporou zprostředkovatelů, určuje podle poskytovatele odpovídající podpůrné použití výchozího poskytovatele nebo poskytovatelů dodávat hodnoty DisplayName vlastnost.Se potom převádí tento skutečné lokalizovaných řetězců pomocí zprostředkovatele DDEX API.

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

public class DDEX_IVsDataSourceExample2
{
    public static string GetSourceDisplayName(
        IServiceProvider serviceProvider,
        IVsDataSource dataSource)
    {
        string displayName = null;
        string resourceId = null;
        Guid provider = dataSource.DefaultProvider;
        if (provider != Guid.Empty)
        {
            resourceId = dataSource.GetProperty(provider, "DisplayName") as string;
        }
        if (resourceId == null)
        {
            foreach (Guid providerId in dataSource.GetProviders())
            {
                resourceId = dataSource.GetProperty(
                    providerId, "DisplayName") as string;
                if (resourceId != null)
                {
                    provider = providerId;
                    break;
                }
            }
        }
        if (provider != Guid.Empty && resourceId != null)
        {
            IVsDataProviderManager providerManager = serviceProvider.GetService(
                typeof(IVsDataProviderManager)) as IVsDataProviderManager;
            IVsDataProvider dataProvider = providerManager.Providers[provider];
            displayName = dataProvider.GetString(resourceId);
        }
        return displayName;
    }
}

Zabezpečení rozhraní .NET Framework

Viz také

Referenční dokumentace

IVsDataSource Rozhraní

GetProperty – přetížení

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