_Table.GetArray(Int32) Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.Outlook

Ensamblado:

Microsoft.Office.Interop.Outlook.dll

Obtiene una matriz bidimensional que contiene un conjunto de valores de fila y columna de Table.

public:
 System::Object ^ GetArray(int MaxRows);

public object GetArray (int MaxRows);

Public Function GetArray (MaxRows As Integer) As Object

Parámetros

MaxRows

Int32

Especifica el número máximo de filas que se devuelven de la tabla.

Devoluciones

Object

Valor object que es una matriz bidimensional que representa un conjunto de valores de fila y columna de table. La matriz es de base cero; una matriz índice (i, j) utiliza un índice en la i-ésima columna y j-ésima fila en la matriz. Las columnas de la matriz corresponden a las columnas de la tabla y las filas de la matriz corresponden a las filas de la tabla. El número de filas de la matriz devuelta es el valor menor de MaxRows y el número real de filas de la tabla.

Comentarios

El método GetArray ofrece una forma conceptualmente sencilla para obtener valores de una tabla copiar toda o parte de los datos de la tabla (basado en la fila actual) a una matriz e indizando la matriz.

GetArray siempre comienza a partir de la fila actual de la tabla. Devuelve una matriz con MaxRows el número de filas si hay al menos MaxRows un número de filas en la tabla a partir de la posición actual. Si MaxRows no es mayor que el número total de filas de la tabla y hay menos MaxRows de elementos en la tabla a partir de la fila actual, devolverá una matriz que contiene solo las filas restantes de la tabla. Si se llama a GetArray y no hay filas restantes, GetArray devuelve una matriz vacía de cero elementos.

Después de obtener las filas correspondientes de la tabla y antes de devolver, GetArray siempre cambia la posición actual fila a la fila siguiente en la tabla, si existe una fila siguiente. GetArray(n) funciona como si GetNextRow() se llamara n veces.

Los valores de las columnas se asignan a columnas en la tabla y, por tanto, se determinan mediante el formato de nombre de la propiedad que se utiliza para la columna. Para obtener más información, vea Factores que afectan a la representación del valor de propiedad en las clases Table y View