WorkbookConnection Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.Excel

Ensamblado:

Microsoft.Office.Interop.Excel.dll

Una conexión es un conjunto de información necesaria para obtener datos de un origen de datos externo distinto de un libro de 1st_Excel12.

public interface class WorkbookConnection

[System.Runtime.InteropServices.Guid("00024485-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface WorkbookConnection

Public Interface WorkbookConnection

Atributos

GuidAttribute InterfaceTypeAttribute

Comentarios

Las conexiones se pueden guardar en un libro de Excel. Cuando se abre el libro, Excel crea una copia en memoria de la conexión a la que se hace referencia como objeto de conexión. Un objeto de conexión contiene información como puede ser el nombre del servidor y el nombre del objeto que se debe abrir en ese servidor. Opcionalmente, el objeto de conexión también puede incluir credenciales de autenticación y/o un comando que se deba pasar al servidor para ejecutarlo (por ejemplo: una instrucción SELECT que deba ejecutar SQL Server).

Nota: La forma exacta de la conexión depende del mecanismo que se usa para recuperar datos: las conexiones ODBC, las conexiones OLEDB y las consultas web contendrán información diferente.

Una conexión también se puede almacenar en un archivo de conexión independiente. La mayoría de las conexiones de un libro de Excel incluyen un puntero a un archivo de conexión externo. Los archivos de conexión tienen extensiones que los identifican claramente como archivos de conexión (*.ODC, *.IQY, etc.) y pueden estar situados en el equipo local del usuario o en otras ubicaciones populares o ubicaciones de confianza, como servidores WSS (biblioteca de conexiones de datos) u otros servidores de tipo empresarial. Los archivos de conexión permiten que varios usuarios de la misma organización reutilicen las conexiones. Los administradores de red pueden cambiar la forma en que toda la organización se conecta a un origen de datos situado en un back-end cambiando un único archivo de conexión. No siempre es necesario utilizar un archivo de conexión para conectar con un origen de datos externo.

Los nombres de conexión son cadenas que identifican de manera inequívoca las conexiones en el libro en el que se utilizan. Hay otras propiedades de las conexiones que no son únicas. Siempre que una fórmula de Excel toma un argumento que sea una conexión, será suficiente con hacer referencia al nombre de dicha conexión, ya sea directamente (como una cadena) o indirectamente (haciendo referencia a una celda que contiene el nombre de la conexión como una cadena).

Propiedades

_Default	Una conexión es un conjunto de información necesaria para obtener datos de un origen de datos externo distinto de un libro de 1st_Excel12.
Application	Cuando se usa sin un calificador de objeto, esta propiedad devuelve un _Application objeto que representa la aplicación de Microsoft Office Excel. Cuando se utiliza con un calificador de objeto, esta propiedad devuelve un objeto Application que representa al creador del objeto especificado. Solo lectura.
Creator	Devuelve un entero de 32 bits que indica la aplicación con la que se creó el objeto. Integer de solo lectura.
DataFeedConnection	Devuelve un objeto DataFeedConnection que contiene los datos y la funcionalidad necesarios para conectarse a fuentes de distribución de datos. Solo lectura
Description	Devuelve o establece una breve descripción de un WorkbookConnection objeto. String de lectura y escritura.
InModel	Especifica si el objeto WorkbookConnection se ha agregado al modelo. Boolean (bool en C#) Solo lectura.
ModelConnection	Devuelve un objeto que contiene información sobre el nuevo tipo de conexión de modelo introducido en Excel 2013 para interactuar con el modelo de datos integrado. Solo lectura
ModelTables	Devuelve un ModelTables objeto asociado a la conexión determinada. Solo lectura
Name	Devuelve o establece el nombre del objeto de conexión del libro. String de lectura y escritura.
ODBCConnection	Vuelve a ajustar los detalles de conexión ODBC para el objeto especificado WorkbookConnection . De solo ODBCConnectionlectura.
OLEDBConnection	Vuelve a ajustar los detalles de conexión OLEDB para el objeto especificado WorkbookConnection . De solo OLEDBConnectionlectura.
Parent	Devuelve el objeto primario del objeto especificado. Solo lectura.
Ranges	Devuelve el intervalo de objeto para el objeto especificado WorkbookConnection . De solo Rangeslectura.
RefreshWithRefreshAll	Determina si se debe actualizar la conexión cuando se ejecuta la actualización de todo. Boolean (bool en C#). Lectura y escritura.
TextConnection	Devuelve un TextConnection objeto que contiene la información de una consulta a un archivo de texto. Solo lectura.
Type	Devuelve el tipo de conexión del libro. De solo XlConnectionTypelectura.
WorksheetDataConnection	Devuelve un objeto que contiene información de una conexión del modelo powerPivot a datos del libro, como un rango, un intervalo con nombre o una tabla. Solo lectura.

Métodos

Delete()	Elimina una conexión de libro.
Refresh()	Actualiza una conexión de libro.