IVsDataProvider.GetProperty-Methode

Ruft eine registrierte Eigenschaft des DDEX-Anbieters ab.

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

Syntax

'Declaration
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

Parameter

• name
  Typ: String

  Der Name der abzurufenden Eigenschaft.

Rückgabewert

Typ: Object
Der Wert der Eigenschaft, wenn vorhanden; andernfalls nullein Nullverweis (Nothing in Visual Basic).

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der name-Parameter ist nullein Nullverweis (Nothing in Visual Basic).

Hinweise

Ein DDEX-Anbieter kann über eine Gruppe auf Eigenschaften registrieren, die DDEX-Clients zugreifen können, um Informationen über den Anbieter zu bestimmen. Standardeigenschaften enthalten den Anbieternamen, den Anzeigenamen, den kurzen Anzeigenamen, die Beschreibung und die Technologie, aber jede Eigenschaft wird vom Anbieter enthalten.

Ein Eigenschaftswert wird abgerufen, indem der DDEX-Stammregistrierungsschlüssel des Anbieters wird geöffnet und einen Wert unter der Schlüssel anfordert, die dem angegebenen Namen. (Der Stammregistrierungsschlüssel befindet sich unter der DataProviders-Taste in den Registrierungshive Visual Studio-lokalerVariable.) Nachdem eine bestimmte Eigenschaft angefordert wurde, wird sein Wert im Arbeitsspeicher von der DDEX-Laufzeit gespeichert und aktualisiert erst, wenn Visual Studio neu gestartet wurde.

Beispiele

Der folgende Code zeigt, wie der Wert der Eigenschaft InvariantName abruft, die in der Regel durch DDEX-Anbieter definiert wird, die auf Grundlage ADO.NET-Technologie sind. Der Wert dieser Eigenschaft wird dann verwendet, um ein ADO.NET-Verbindungsobjekt durch die DbProviderFactory-APIs zu erstellen.

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-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

IVsDataProvider Schnittstelle

Microsoft.VisualStudio.Data.Core-Namespace