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.Framework.ServiceProvider
    Microsoft.VisualStudio.Data.Framework.DataSiteableServiceProvider<IVsDataConnection>
      Microsoft.VisualStudio.Data.Framework.DataConnectionSupport
        Microsoft.VisualStudio.Data.Framework.AdoDotNet.AdoDotNetConnectionSupport

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

Sintassi

'Dichiarazione
Public MustInherit Class DataConnectionSupport _
    Inherits DataSiteableServiceProvider(Of IVsDataConnection) _
    Implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents
public abstract class DataConnectionSupport : DataSiteableServiceProvider<IVsDataConnection>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents
public ref class DataConnectionSupport abstract : public DataSiteableServiceProvider<IVsDataConnection^>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents
[<AbstractClass>]
type DataConnectionSupport =  
    class 
        inherit DataSiteableServiceProvider<IVsDataConnection>
        interface IVsDataConnectionSupport 
        interface IServiceProvider 
        interface IDisposable 
        interface IVsDataConnectionEvents 
    end
public abstract class DataConnectionSupport extends DataSiteableServiceProvider<IVsDataConnection> implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

Il tipo DataConnectionSupport espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo protetto DataConnectionSupport Inizializza una nuova istanza della classe DataConnectionSupport.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica ConnectionString Ottiene o imposta una rappresentazione di stringa di informazioni richiesta di stabilire una connessione a un'origine dati.
Proprietà pubblica ConnectionTimeout Ottiene o imposta la quantità di tempo di attesa quando si stabilisce una connessione prima della terminazione del tentativo e la generazione di un errore di timeout.
Proprietà protetta. ParentProvider Ottiene l'istanza corrente del provider di servizi padre. (Ereditato da ServiceProvider)
Proprietà pubblica ProviderObject Ottiene il provider di dati sottostante, che supporta la connessione dati corrente.
Proprietà protetta. ServiceProvider Ottiene il provider di servizi Visual Studio generale.
Proprietà pubblica Site Ottiene o imposta il sito. (Ereditato da DataSiteableServiceProvider<T>)
Proprietà pubblica State Ottiene lo stato della connessione dati.

In alto

Metodi

  Nome Descrizione
Metodo pubblico AddService(Type, ServiceCreatorCallback) Aggiunge il servizio specificato alla raccolta interna di servizi. (Ereditato da ServiceProvider)
Metodo pubblico AddService(Type, Object) Aggiunge il servizio specificato alla raccolta interna di servizi. (Ereditato da ServiceProvider)
Metodo pubblico AddService(Type, ServiceCreatorCallback, Boolean) Aggiunge il servizio specificato alla raccolta interna di servizi o al contenitore padre del servizio. (Ereditato da ServiceProvider)
Metodo pubblico AddService(Type, Object, Boolean) Aggiunge il servizio specificato alla raccolta di oggetti servizi o al contenitore padre del servizio. (Ereditato da ServiceProvider)
Metodo pubblico Close Chiude la connessione specificata.
Metodo protetto CreateService Crea un nuovo oggetto servizio, specificando il tipo dell'interfaccia.
Metodo pubblico Dispose() Libera tutte le risorse utilizzate da connessione dati.
Metodo protetto Dispose(Boolean) Libera tutte le risorse utilizzate da connessione dati.
Metodo pubblico Equals Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo protetto Finalize Libera tutte le risorse utilizzate dalla connessione dati quando l'oggetto di supporto della connessione dati viene eliminata. (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 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 OnMessageReceived Consente di gestire l'evento MessageReceived.
Metodo protetto OnSiteChanged Genera l'evento SiteChanged. (Ereditato da DataSiteableServiceProvider<T>)
Metodo protetto OnStateChanged Consente di gestire l'evento StateChanged.
Metodo pubblico Open Aprire la connessione dati.
Metodo pubblico RemoveService(Type) Rimuove il servizio specificato dai servizi interni di raccolta (Ereditato da ServiceProvider)
Metodo pubblico RemoveService(Type, Boolean) Rimuove il servizio specificato dalla raccolta interna di servizi o dal contenitore padre del servizio. (Ereditato da ServiceProvider)
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Eventi

  Nome Descrizione
Evento pubblico MessageReceived Si verifica quando un messaggio viene ricevuto dall'origine dati.
Evento pubblico SiteChanged Si verifica quando il sito viene modificato. (Ereditato da DataSiteableServiceProvider<T>)
Evento pubblico StateChanged Si verifica quando lo stato della connessione dati è stato modificato.

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato IServiceProvider.QueryService Esegue la factory per i servizi esposti tramite un'implementazione IServiceProvider. (Ereditato da ServiceProvider)

In alto

Note

La classe DataConnectionSupport rappresenta l'implementazione del provider di dati per supportare una connessione dati.

Le proprietà e i metodi di questa classe fornisce la funzionalità di base che consente al provider di dati comunicare con l'origine dati, per l'esecuzione di tali attività come apertura e chiusura le connessioni e recuperare lo stato della connessione. Un provider di dati può inoltre esporre i servizi specializzati eseguire l'override del metodo CreateService. I servizi connessione- correlati correnti possono essere riepilogati i seguenti:

  • IVsDataObjectSupport: Fornisce un metodo per recuperare codice XML che descrive i tipi di oggetti dati supportati dall'origine dati e le azioni che è possibile eseguire su di essi.

  • IVsDataObjectIdentifierResolver: Fornisce un metodo per la risoluzione degli identificatori dell'oggetto dati.

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

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

  • IVsDataCommand: Consente di derivare da ed eseguire i vari tipi di controlli.

  • IVsDataAsyncCommand: Abilita che esegue i comandi dati in modo asincrono.

  • IVsDataTransaction: Consente di avviare, il commit e ripristinare le transazioni.

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

  • IVsDataSourceInformation: Fornisce un set di coppie nome/valore ben definite sull'origine dati.

  • IVsDataMappedObjectConverter: Abilita che fornisce un'utilità di mapping personalizzato dei metadati specifici di origine dati i concetti utilizzati da una finestra di progettazione generica.

  • IVsDataObjectSelector: Abilita che ottiene i dati di origine metadati specifici sugli oggetti definiti nel file XML di supporto dell'oggetto dati.

  • IDSRefBuilder: Consente di creare un oggetto di (DSRef) di riferimento di origine dati che identifica uno o più oggetti dati.

Questa classe implementa l'interfaccia IVsDataSiteableObject<T>, che consente di DDEX sito l'implementazione DataConnectionSupport di un provider di dati con l'oggetto IVsDataConnection che viene chiamata in. Ciò fornisce l'implementazione al contesto nonché mezzi per recuperare i servizi di Visual Studio.

Note per gli eredi

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 CreateService per fornire la propria implementazione dei servizi di connessione. Quando un cambiamento di stato o un evento ricevuto messaggio- caso, una classe derivata deve, se possibile, chiamare il OnStateChanged e i metodi protetti OnMessageReceived.

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.Framework