Classe DataConnection

Supporta una connessione a un'origine dati.

Gerarchia di ereditarietà

Object
  Microsoft.VisualStudio.Data.ServiceProvider
    Microsoft.VisualStudio.Data.DataConnection

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

Sintassi

'Dichiarazione
Public MustInherit Class DataConnection _
    Inherits ServiceProvider _
    Implements ICloneable, IDisposable

public abstract class DataConnection : ServiceProvider, 
    ICloneable, IDisposable

public ref class DataConnection abstract : public ServiceProvider, 
    ICloneable, IDisposable

[<AbstractClass>]
type DataConnection =  
    class 
        inherit ServiceProvider 
        interface ICloneable 
        interface IDisposable 
    end

public abstract class DataConnection extends ServiceProvider implements ICloneable, IDisposable

Il tipo DataConnection espone i seguenti membri.

Costruttori

	Nome	Descrizione
	DataConnection	Costruttore di classe.Crea una nuova istanza della classe DataConnection.

In alto

Proprietà

	Nome	Descrizione
	AsyncCommand	Recupera un oggetto che può eseguire la derivazione asincrona e l'esecuzione di controlli nell'origine dati.
	Command	Recupera un oggetto che può eseguire la derivazione e l'esecuzione di controlli nell'origine dati.
	ConnectionSupport	Recupera l'oggetto di supporto di connessione del provider di dati sottostante che viene utilizzato per supportare l'istanza corrente della connessione dati.
	ConnectionTimeout	Recupera o presenta il tempo di attesa, in secondi, un comando aprire la durata della connessione a.
	DisplayConnectionString	Recupera o imposta le informazioni di connessione non crittografate sotto forma di stringa DDEX-provider- specifica.
	EncryptedConnectionString	Recupera o imposta le informazioni di connessione crittografate sotto forma di stringa DPAPI- crittografata e specifica.
	IsLockedForExclusiveAccess	Recupera un valore booleano che indica se la connessione corrente è bloccata da un client per l'accesso esclusivo.
	ObjectChangeEvents	Recupera un oggetto che fornisce un insieme di eventi generati quando gli oggetti dati nell'origine dati vengono aggiunti, modificati, o rimossi.
	ObjectIdentifierConverter	Recupera un oggetto che può convertire gli identificatori dell'oggetto dati da stringhe formattate alle parti senza formato e viceversa.
	ObjectIdentifierResolver	Recupera un oggetto che può risolvere gli identificatori dell'oggetto dati sia con l'espansione della contrazione.
	ObjectItemComparer	Recupera un oggetto che può confrontare le parti e le proprietà dell'identificatore su oggetti dati.
	ObjectSupport	Recupera un oggetto che fornisce un flusso XML che definisce i vari tipi di oggetto dati di DDEX supportati dalla connessione dati corrente.
	Provider	Recupera l'identificatore univoco del provider di DDEX per la connessione dati corrente.
	ProviderObjectIsLocked	Recupera un valore booleano che indica se l'oggetto provider sottostante di DDEX è bloccato da un client.
	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)
	Source	Recupera l'identificatore univoco globale (GUID) dell'origine dati per la connessione dati corrente, se disponibile.
	SourceInformation	Recupera un oggetto che fornisce un set di coppie nome/valore noto che descrivono le caratteristiche dell'origine dati.
	SourceVersionComparer	Recupera un oggetto che consente di confrontare i numeri di versione dati-database di origine- specifici.
	State	Recupera lo stato corrente di questa connessione dati.
	Transaction	Recupera un oggetto che consente l'elaborazione delle transazioni, ovvero consente all'inizio, al commit e alle transazioni di rollback dell'origine dati.
	ViewSupport	Recupera un oggetto che fornisce un flusso XML che definisce le varie visualizzazioni dati supportati dalla connessione dati corrente.

In alto

Metodi

	Nome	Descrizione
	Clone	Crea un'istanza duplicata di questa connessione dati, che mantiene le stesse proprietà e stato di connessione dell'originale.
	Close	Chiude la connessione dati corrente.
	Dispose()	La connessione dati corrente e tutte le relative risorse collegate.
	Dispose(Boolean)	Supporta l'infrastruttura di DDEX e non deve essere utilizzato direttamente dal codice.
	Equals	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	EquivalentTo	Recupera un valore booleano che indica se viene fatto che le informazioni sulla connessione corrente sono equivalenti, in fase di progettazione, informazioni di connessione specificate.
	Finalize	Viene completato la connessione. (Esegue l'override di Object.Finalize).
	GetExclusiveAccessProxy	Recupera un'istanza proxy che consente l'accesso esclusivo del chiamante alla connessione dati.
	GetHashCode	Funge da funzione hash predefinita. (Ereditato da Object)
	GetLockedProviderObject()	Recupera l'oggetto del provider di dati sottostante, se presente, che supporta la connessione dati corrente.
	GetLockedProviderObject(Int32)	Recupera l'oggetto del provider di dati sottostante, se presente, che supporta la connessione dati corrente.
	GetService(Guid)	Recupera un servizio tramite un servizio specificato GUID. (Ereditato da ServiceProvider)
	GetService(Type)	Recupera un servizio del tipo specificato. (Ereditato da ServiceProvider)
	GetServiceImpl(Guid)	Fornisce l'implementazione per recuperare un servizio con un GUID specifico. (Ereditato da ServiceProvider)
	GetServiceImpl(Type)	Fornisce l'implementazione per recuperare un servizio di un tipo specifico. (Ereditato da ServiceProvider)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	MemberwiseClone	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
	OnMessageReceived	Gestore per l'evento MessageReceived.
	OnStateChanged	Gestore per l'evento StateChanged.
	Open	Aprire questa connessione dati.
	ReleaseExclusiveAccessProxy	Rilascia un proxy esistente di accesso esclusivo, direttamente con una chiamata al metodo GetExclusiveAccessProxy.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
	UnlockProviderObject	Sblocca un oggetto provider di DDEX che è stato bloccato mediante una chiamata al metodo GetLockedProviderObject.

In alto

Eventi

	Nome	Descrizione
	MessageReceived	Evento generato quando un messaggio viene ricevuto dall'origine dati.
	StateChanged	Evento generato quando lo stato della connessione dati è cambiato.

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	ICloneable.Clone	Crea una nuova istanza di un oggetto connessione che è una copia dell'istanza corrente.
	IServiceProvider.QueryService	Esegue la factory per i servizi esposti tramite un'implementazione di IServiceProvider. (Ereditato da ServiceProvider)

In alto

Note

Questa classe fornisce la comunicazione di base con un'origine dati, supportare funzionalità quali l'apertura e chiudere le connessioni. Fornisce inoltre l'accesso a un set di servizi che espongono funzionalità più specifiche sull'origine dati.

DDEX fornisce una singola implementazione della classe, nessun provider di dati deve fornire la propria implementazione della classe DataConnection. Invece, i provider di DDEX devono implementare la classe DataConnectionSupport, che viene quindi eseguito il wrapping dall'istanza DataConnection.

Il vantaggio di questo approccio è che consente di DDEX fornire una funzionalità chiave sia al client che al provider di dati: blocco di connessione in modo che possa condividere la stessa connessione ma non creare i client più conflitti. Con questa architettura, i client non devono preoccuparsi del conflitto tra loro e i provider di dati non devono preoccuparsi di accesso multithreading.

La classe DataConnection possibile ottenere questo livello di blocco da soddisfare oggetto proxy per l'istanza della classe DataConnectionSupportnonché fornendo oggetti proxy per ogni servizio noto di DDEX disponibile dalla connessione. Questi proxy implementano ogni metodo e proprietà blocca la connessione, quindi chiamare l'implementazione del provider di dati, quindi sbloccante la connessione.

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

ICloneable

IDisposable