Método IVsDataProvider.GetString

Artigo
05/17/2015

Obtém uma cadeia de caracteres localizada do provedor de DDEX.

Namespace: Microsoft.VisualStudio.Data.Core
Assembly: Microsoft.VisualStudio.Data.Core (em Microsoft.VisualStudio.Data.Core.dll)

Sintaxe

'Declaração
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

Parâmetros

resourceId
Tipo: String

O identificador do recurso de cadeia de caracteres para recuperar.

Valor de retorno

Tipo: String
O valor do recurso localizado de cadeia de caracteres, se o ID de recurso é válido e identifica um recurso existente; caso contrário, nulluma referência nula (Nothing no Visual Basic).

Exceções

Exceção	Condição
ArgumentNullException	O parâmetro resourceId é nulluma referência nula (Nothing no Visual Basic).

Comentários

Um provedor de DDEX pode expor vários IDs de recurso para cadeias de caracteres localizadas, como um nome para exibição e descrição. Esses IDs de recurso são acessados por clientes de DDEX que pesquisam na cadeia de caracteres encontrada real chamar esse método.

Um ID de recurso do provedor de DDEX pode vir de duas formas. O primeiro permite consultar cadeias de caracteres de recursos gerenciados e tem o formato Nome, Recurso [, Assembly]. A seguir está um exemplo de um ID de recurso neste formulário: SqlProvider_DisplayName, MyResources, MyAssembly. GetString analisar as cadeias de caracteres de recurso e chama o método de GetAssembly para resolver qualquer conjunto que é especificado em uma cadeia de caracteres. O segundo formulário permite consultar cadeias de caracteres de recurso em pacotes, e tem o formato #NNNN onde NNNN é a identificação inteiro de recurso no pacote. Um exemplo de um ID de recurso neste formulário é #3021. O segundo formulário é menos comum e se aplica somente quando o provedor de DDEX pacote é baseado.

Exemplos

O código a seguir demonstra como recuperar manualmente o nome para exibição de um provedor de 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;
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

IVsDataProvider Interface

Namespace Microsoft.VisualStudio.Data.Core

Partilhar via