Condividi tramite


Classe DataConnectionSupport

Fornisce proprietà e metodi che consentono di utilizzare direttamente le connessioni a un'origine dati.

Gerarchia di ereditarietà

Object
  Microsoft.VisualStudio.Data.ServiceProvider
    Microsoft.VisualStudio.Data.ServiceProviderWithSite
      Microsoft.VisualStudio.Data.DataConnectionSupport
        Microsoft.VisualStudio.Data.AdoDotNet.AdoDotNetConnectionSupport

Spazio dei nomi:  Microsoft.VisualStudio.Data
Assembly:  Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)

Sintassi

'Dichiarazione
Public MustInherit Class DataConnectionSupport _
    Inherits ServiceProviderWithSite _
    Implements IDisposable
public abstract class DataConnectionSupport : ServiceProviderWithSite, 
    IDisposable
public ref class DataConnectionSupport abstract : public ServiceProviderWithSite, 
    IDisposable
[<AbstractClass>]
type DataConnectionSupport =  
    class 
        inherit ServiceProviderWithSite 
        interface IDisposable 
    end
public abstract class DataConnectionSupport extends ServiceProviderWithSite implements IDisposable

Il tipo DataConnectionSupport espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo protetto DataConnectionSupport Costruttore di classe.Creazione di un'istanza nonparameterized della classe DataConnectionSupport.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica ConnectionString Recupera o imposta una rappresentazione di stringa di informazioni richiesta di stabilire una connessione a un'origine dati.
Proprietà pubblica ConnectionTimeout Recupera o imposta il tempo di attesa, in secondi, di attesa per stabilire una connessione prima di terminare il tentativo e la generazione di un errore di timeout.
Proprietà pubblica ProviderObject Recupera l'oggetto del provider di dati sottostante per la connessione specificata.
Proprietà protetta. ServiceTypes Recupera un elenco di tipi di servizi utilizzati per convertire la chiamata al metodo non gestita QueryService, in cui un servizio GUID è specificato, in una chiamata al metodo gestito IServiceProvider.GetService, in cui viene specificato un tipo gestito. (Ereditato da ServiceProvider)
Proprietà pubblica Site Recupera o imposta l'istanza del sito. (Ereditato da ServiceProviderWithSite)
Proprietà pubblica State Recupera lo stato della connessione dati.

In alto

Metodi

  Nome Descrizione
Metodo pubblico Close Chiude la connessione specificata.
Metodo pubblico Dispose() Esegue attività associate alla liberazione, al rilascio o alla reimpostazione delle risorse.
Metodo protetto Dispose(Boolean) Esegue attività associate alla liberazione, al rilascio o alla reimpostazione delle risorse.
Metodo pubblico Equals Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo protetto Finalize Viene completato la connessione. (Esegue l'override di Object.Finalize).
Metodo pubblico GetHashCode Funge da funzione hash predefinita. (Ereditato da Object)
Metodo pubblico GetService(Guid) Recupera un servizio tramite un servizio specificato GUID. (Ereditato da ServiceProvider)
Metodo pubblico GetService(Type) Recupera un servizio del tipo specificato. (Ereditato da ServiceProvider)
Metodo protetto GetServiceImpl(Type) Per recuperare i servizi di implementazione. (Esegue l'override di ServiceProvider.GetServiceImpl(Type)).
Metodo protetto GetServiceImpl(Guid) Fornisce l'implementazione per recuperare un servizio con un GUID specifico. (Ereditato da ServiceProvider)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico Initialize Inizializza la connessione specificata, facoltativamente da un oggetto esistente del provider di dati.
Metodo protetto MemberwiseClone Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Metodo protetto OnSiteChanged Genera l'evento SiteChanged. (Ereditato da ServiceProviderWithSite)
Metodo pubblico Open Aprire la connessione specificata.
Metodo protetto RaiseMessageReceived Genera l'evento MessageReceivednell'istanza di inclusione DataConnection.
Metodo protetto RaiseStateChanged Genera l'evento stato modificato nell'istanza di inclusione DataConnection.
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Eventi

  Nome Descrizione
Evento pubblico SiteChanged Evento generato quando la proprietà Site è stato modificato. (Ereditato da ServiceProviderWithSite)

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato IObjectWithSite.GetSite Recupera l'ultimo sito impostato utilizzando il metodo IObjectWithSite.SetSite.Se non esiste alcun sito noto, viene generata un'eccezione. (Ereditato da ServiceProviderWithSite)
Implementazione esplicita dell'interfacciaMetodo privato IServiceProvider.QueryService Esegue la factory per i servizi esposti tramite un'implementazione di IServiceProvider. (Ereditato da ServiceProvider)
Implementazione esplicita dell'interfacciaMetodo privato IObjectWithSite.SetSite Fornisce il puntatore IUnknown di un sito in un oggetto specificato. (Ereditato da ServiceProviderWithSite)

In alto

Note

La classe DataConnectionSupport rappresenta l'implementazione del provider di dati per supportare una connessione dati. L'architettura di DDEX implementa la classe DataConnection chiamando in DataConnectionSupport del provider un'implementazione specifica.

Le proprietà e i metodi della classe forniscono la funzionalità di base che consenta al provider di dati comunicare con l'origine dati, eseguendo tali attività come apertura e chiusura connessioni e recuperare lo stato della connessione. Un provider di dati può inoltre esporre i servizi specifici mediante l'override del metodo GetServiceImpl. Questi servizi connessione- correlati sono riepilogati seguito:

  • DataViewSupport: Fornisce un metodo per recuperare codice XML che descrive le visualizzazioni specifiche di un'origine dati oggetti dati da visualizzare in Esplora server Visual Studio.

  • DataObjectSupport: Fornisce un metodo per recuperare XML che descrive i tipi di oggetti dati supportati dall'origine dati e azioni che possono essere eseguite su di essi.

  • DataObjectIdentifierResolver: Fornisce un metodo per risolvere gli identificatori dell'oggetto dati.

  • DataObjectIdentifierConverter: Fornisce metodi per la conversione tra la stringa e le rappresentazioni di matrice di identificatori dell'oggetto dati.

  • DataObjectItemComparer: Fornisce metodi per confrontare le parti e i valori della proprietà dell'identificatore di oggetto dati.

  • DataCommand: Consente di creare ed eseguire i vari tipi di controlli.

  • DataAsyncCommand: Consente di eseguire i comandi dati in modo asincrono.

  • DataTransaction: Consente di avviare, il commit e annullare transazioni.

  • DataSourceVersionComparer: Fornisce un metodo per confrontare due stringhe dati-database di origine- specifiche della versione.

  • DataSourceInformation: Fornisce un set di coppie nome/valore ben definite che descrivono l'origine dati.

Questa classe implementa l'interfaccia IObjectWithSite, che consente di DDEX collochi l'implementazione DataConnectionSupport di un provider di dati con l'oggetto DataConnection che effettua la chiamata in. Ciò fornisce l'implementazione al contesto e con mezzi per recuperare i servizi Visual Studio.

Qualsiasi classe derivata deve implementare le varie proprietà e metodi astratti per supportare la connessione. Una classe derivata deve anche eseguire l'override del metodo protetto GetServiceImplper fornire ai servizi di connessione. Quando un cambiamento di stato o un evento messaggio- ricevuto caso, una classe derivata, laddove possibile chiamare il RaiseStateChanged e metodi protetti RaiseMessageReceived, che la classe base quindi passa all'oggetto contenuto DataConnection.

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Data

ServiceProviderWithSite

IDisposable