IVsDataSource.GetProperty (Método) (Guid, String)

Obtiene una propiedad de origen de datos de DDEX como registrado por un proveedor específico de DDEX que admite.

Espacio de nombres:  Microsoft.VisualStudio.Data.Core
Ensamblado:  Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)

Sintaxis

'Declaración
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

Parámetros

• provider
  Tipo: System.Guid
  El identificador de un proveedor de DDEX que admite.

• name
  Tipo: System.String
  Nombre de la propiedad que se va a recuperar.

Valor devuelto

Tipo: System.Object
El valor de la propiedad, si existe; si no, nullreferencia null (Nothing en Visual Basic).

Excepciones

Comentarios

Un origen de datos de DDEX puede registrar un conjunto de propiedades cuyo acceso por los clientes de DDEX para determinar información sobre el origen de datos.Además, cada proveedor de DDEX que admite un origen de datos de DDEX puede registrar las propiedades proveedor- específicas asociadas al origen de datos de DDEX.

Cuando el parámetro de provider es un GUID vacío, recupera de este método un valor de propiedad global del origen de datos abriendo el clave del Registro de la raíz del origen de datos de DDEX (bajo la clave de DataSources en el subárbol local del registro de Visual Studio) y solicitar un valor bajo la clave que tiene nameespecificado.Cuando el parámetro provider es un identificador válido de proveedor de DDEX que admite, recupera de este método un valor de propiedad proveedor- específico del origen de datos abriendo la subclave de proveedor que admite en clave del Registro de la raíz del origen de datos y solicitar un valor bajo esta subclave con nameespecificado.Después de que se ha solicitado una propiedad concreta, su valor se guarda en la memoria por el runtime de DDEX y no se actualiza hasta que se reinicie Visual Studio.

Ejemplos

El código siguiente muestra la implementación de la propiedad de DisplayName .Dado que las cadenas localizadas proporciona solo admiten los proveedores, determina un proveedor que admite adecuado al usar según el proveedor predeterminado o que los proveedores proporciona valores para la propiedad de DisplayName .A continuación se resuelve esto a la cadena adaptada real mediante la API de proveedor de 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;
    }
}

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

IVsDataSource Interfaz

GetProperty (Sobrecarga)

Microsoft.VisualStudio.Data.Core (Espacio de nombres)