IVsDataProvider.GetProperty (Método)
Obtiene una propiedad registrada de proveedor de DDEX.
Espacio de nombres: Microsoft.VisualStudio.Data.Core
Ensamblado: Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)
Sintaxis
'Declaración
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
Parámetros
- 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
| Excepción | Condición |
|---|---|
| ArgumentNullException | El valor del parámetro name es nullreferencia null (Nothing en Visual Basic). |
Comentarios
Un proveedor de DDEX puede registrar un conjunto de propiedades para que los clientes de DDEX puedan tener acceso para determinar información sobre el proveedor.Las propiedades estándar incluyen el nombre del proveedor, el nombre para mostrar, el nombre para mostrar abreviada, la descripción, y la tecnología, pero cualquier propiedad puede estar incluido en el proveedor.
Un valor de propiedad es recuperado abriendo el clave del Registro de la raíz del proveedor de DDEX y solicitar un valor bajo la clave con el nombre especificado.(El clave de Registro raíz se encuentra situado bajo la clave de DataProviders en el subárbol local del registro de Visual Studio). 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 cómo recuperar el valor de la propiedad de InvariantName , que se define normalmente por los proveedores de DDEX que se basan en la tecnología de ADO.NET.El valor de esta propiedad se utiliza para crear un objeto de conexión ADO.NET con el DbProviderFactory API.
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;
}
}
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.