Proprietà ActiveConnection (ADO MD)

Indica a quale oggetto Connection ADO appartiene attualmente il set di celle o il catalogo corrente.

Impostazioni e valori restituiti

Imposta o restituisce un valore Variant contenente una stringa che definisce una connessione o un oggetto Connection. Per impostazione predefinita, è vuoto.

Osservazioni

È possibile impostare questa proprietà su un oggetto Connection ADO valido o su una stringa di connessione valida. Quando questa proprietà è impostata su una stringa di connessione, il provider crea un nuovo oggetto Connection usando questa definizione e apre la connessione.

Se si utilizza l'argomento ActiveConnection del metodo Open per aprire un oggetto Cellset, la proprietà ActiveConnection erediterà il valore dell'argomento.

L'impostazione della proprietà ActiveConnection di un oggetto Catalog su Nothing rilascia i dati associati, inclusi i dati nella raccolta CubeDefs ed eventuali oggetti Dimension, Hierarchy, Level e Member correlati. La chiusura di un oggetto Connection utilizzato per aprire un oggetto Catalog ha lo stesso effetto dell'impostazione della proprietà ActiveConnection su Nothing.

La modifica del database predefinito della connessione a cui fa riferimento la proprietà ActiveConnection di un oggetto Catalog invalida il contenuto del Catalogo.

Se si tenta di modificare la proprietà ActiveConnection per un oggetto Cellset aperto, si verificherà un errore.

Nota

In Visual Basic ricordarsi di utilizzare la parola chiave Set quando si imposta la proprietà ActiveConnection su un oggetto Connection. Se si omette la parola chiave Set, verrà effettivamente impostata la proprietà ActiveConnection uguale alla proprietà predefinita dell'oggetto Connection, ConnectionString. Il codice funzionerà; tuttavia, si creerà una connessione aggiuntiva all'origine dati, che potrebbe avere implicazioni negative sulle prestazioni.

Quando si usa il provider di dati MSOLAP, impostare l'origine dati in una stringa di connessione su un nome del server e impostare il catalogo iniziale sul nome di un catalogo dall'origine dati. Per connettersi a un file di cubo disconnesso da un server, impostare il percorso completo sul file .CUB. In entrambi i casi, impostare il provider sul nome del provider. Ad esempio, la stringa seguente usa il provider MSOLAP per connettersi a un catalogo denominato Bobs Video Store in un server denominato Servername:

"Data Source=Servername;Initial Catalog=Bobs Video Store;Provider=msolap"  

La stringa seguente si connette a un file di cubo locale nel percorso C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub:

"Location=C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub;Provider=msolap"  

Si applica a

Oggetto Catalog (ADO MD)

Oggetto Cellset (ADO MD)

Vedere anche

Esempio di Cellset (VB)
Oggetto Connection (ADO)
Metodo Open (ADO MD)