IVsDataProvider.GetString - метод

Статья
05/17/2015

Возвращает локализованную строку от поставщика DDEX.

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

Синтаксис

'Декларация
Function GetString ( _
    resourceId As String _
) As String

string GetString(
    string resourceId
)

String^ GetString(
    String^ resourceId
)

abstract GetString : 
        resourceId:string -> string

function GetString(
    resourceId : String
) : String

Параметры

resourceId
Тип: String

Идентификатор строкового ресурса, который необходимо извлечь.

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

Тип: String
Локализованное значение строкового ресурса, если идентификатор ресурса допустимым и определяет ресурса; в противном случае nullссылка NULL (Nothing в Visual Basic).

Исключения

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

Заметки

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

Идентификатор ресурса поставщика DDEX могут быть получены в 2 формы. Первое включает поиск управляемые строки ресурсов и имеет формат Имя, Ресурс [, Сборка]. Ниже приведен пример идентификатора ресурса в этой форме: SqlProvider_DisplayName, MyResources, MyAssembly. GetString анализирует строки ресурсов и вызывает метод GetAssembly для разрешения любой сборки, указанной в строке. Вторая форма включает поиск строки ресурсов в пакетах и имеет формат #nnnn, где nnnn — это идентификатор целые числа ресурса в пакете. Пример идентификатора ресурса в этой форме #3021. Вторая форма менее общая и применяется, только если поставщик DDEX на пакет.

Примеры

В следующем примере демонстрируется, как вручную извлечь отображаемое имя поставщика DDEX.

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

public class DDEX_IVsDataProviderExample5
{
    public static string GetDisplayName(
        IVsDataProvider provider)
    {
        string displayName = String.Empty;
        string resourceId = provider.GetProperty("DisplayName") as string;
        if (resourceId != null)
        {
            displayName = provider.GetString(resourceId);
        }
        return displayName;
    }
}

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

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

См. также

Ссылки

IVsDataProvider Интерфейс

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

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