Поделиться через

IVsDataSource.GetProperty - метод (Guid, String)

  • Статья

Получает свойство источника данных DDEX регистрация поддержка DDEX конкретным поставщиком.

Пространство имен:  Microsoft.VisualStudio.Data.Core
Сборка:  Microsoft.VisualStudio.Data.Core (в Microsoft.VisualStudio.Data.Core.dll)

Синтаксис

'Декларация
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

Параметры

  • provider
    Тип: Guid

    Идентификатор поставщика поддержки DDEX.

  • name
    Тип: String

    Имя извлекаемого свойства.

Возвращаемое значение

Тип: Object
Значение свойства, если существует; в противном случае nullссылка NULL (Nothing в Visual Basic).

Исключения

Исключение Условие
ArgumentNullException

Значение параметра name — nullссылка NULL (Nothing в Visual Basic).

Заметки

Источник данных может регистрировать DDEX набор свойств, доступно клиентами DDEX для получения сведений об источнике данных. Кроме того, каждый поставщик DDEX источник данных, поддерживающий DDEX может регистрировать свойств, связанных с поставщиком, связанные с источником данных DDEX.

Если параметр provider пустой GUID, этот метод возвращает глобальное значение свойства источника данных, откройте раздел реестра корневого источника данных DDEX (в источниками данных этому в кусте реестра Visual Studio локальном) и запрос значение в ключом, который имеет указанное name. Если параметр поставщика поддержки допустимый идентификатор поставщика DDEX, этот метод возвращает значение свойства источника данных, связанных с поставщиком, открыв подраздела поддержки поставщика в разделе реестра корневого источника данных и запрос значение в нее подразделом с указанным name. После того как конкретное свойство в запросе, его значение сохраняется в памяти средой выполнения DDEX и не обновляется до тех пор, пока не перезапуске Visual Studio.

Примеры

В следующем примере кода демонстрируется реализация свойства DisplayName. Поскольку локализованные строки предоставляются только за счет поддержки поставщиков, он определяет соответствующий поддержки поставщика на основе поставщика по умолчанию и поставщики, указываются значения для свойства DisplayName. Затем он позволяет это локализованной строки в соответствии с помощью API поставщика DDEX.

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;
    }
}

Безопасность платформы .NET Framework

См. также

Ссылки

IVsDataSource Интерфейс

GetProperty - перегрузка

Microsoft.VisualStudio.Data.Core - пространство имен