IVsDataProvider.GetProperty - метод

Статья
05/17/2015

Возвращает зарегистрированное свойство поставщика DDEX.

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

Синтаксис

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

Параметры

name
Тип: String

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

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

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

Исключения

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

Заметки

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

Значение свойства извлечения, откройте раздел реестра корневого поставщика DDEX и запрос значение в ключом, который имеет указанное имя. (Раздел реестра расположен в корневой DataProviders ключом в кусте реестра Visual Studio локальном). После того как конкретное свойство в запросе, его значение сохраняется в памяти средой выполнения DDEX и не обновляется до тех пор, пока не перезапуске Visual Studio.

Примеры

В следующем примере демонстрируется, как получить значение свойства InvariantName, которое обычно определяется поставщиками DDEX, основанные на технологии ADO.NET. Значение этого свойства затем используется для создания объекта подключения ADO.NET с помощью 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;
    }
}

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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.

См. также

Ссылки

IVsDataProvider Интерфейс

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

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