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

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
    Тип: System.Guid
    Идентификатор поддержка поставщика DDEX.
  • name
    Тип: System.String
    Имя извлекаемого свойства.

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

Тип: System.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 - пространство имен