Método DataRecordset.GetDataRowIDs (Visio)

Obtiene una matriz de los identificadores de todas las filas del conjunto de registros de datos.

Nota:

Este objeto o miembro Visio solo se encuentra disponible para los usuarios con licencia de Visio Professional 2013.

Sintaxis

expresión. GetDataRowIDs (CriteriaString)

Expresión Expresión que devuelve un objeto DataRecordset .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
CriteriaString	Obligatorio	String	Cadena que se ajusta a las directrices especificadas en la API de Microsoft ActiveX Data Object (ADO) para el establecimiento de la propiedad ADO.Filter.

Valor devuelto

Long()

Comentarios

Use el método GetDataRowIDs para obtener una matriz de los identificadores de todas las filas de un conjunto de registros de datos, donde cada fila representa un único registro de datos. El método GetDataRowIDs adopta como parámetro una cadena de criterios, que se ajusta a las directrices especificadas en la API de ADO para el establecimiento de la propiedad ADO.Filter. Mediante la especificación de los criterios adecuados y el uso de los operadores AND y OR para separar cláusulas, puede filtrar la información del conjunto de registros de datos para que solo se devuelvan algunas filas de este conjunto de registros selectivamente. Para no aplicar ningún filtro (es decir, para obtener todas las filas), pase una cadena vacía ("").

Para obtener más información sobre las cadenas de criterios, vea Filter Property en la referencia de api de ADO 2.8.

Ejemplo:

Esta macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo puede usar los métodos GetDataRowIDs y GetRowData para devolver el identificador de fila de cada fila y, a continuación, obtener los datos almacenados en cada columna de cada fila del conjunto de registros de datos especificado. La macro obtiene el recuento de todos los conjuntos de registros de datos asociados al documento actual y obtiene los datos de fila del agregado más recientemente. Recorre en iteración todas las filas del conjunto de registros de datos y, a continuación, recorre en iteración todas las columnas de esa fila. El código muestra la información devuelta en la ventana Inmediato.

Antes de ejecutar esta macro, cree al menos un conjunto de registros de datos en el documento actual.

Observe que la macro pasa una cadena vacía al método GetDataRowIDs con el fin de omitir el proceso de filtrado y obtener todas las filas del conjunto de registros. Después de ejecutar la macro, observe que el primer conjunto de datos mostrado (que corresponde a la primera fila de datos) contiene los encabezados de todas las columnas de datos del conjunto de registros de datos.

Public Sub GetDataRowIDs_Example() 
 
     
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
    Dim lngRowIDs() As Long 
    Dim lngRow As Long 
    Dim lngColumn As Long 
    Dim varRowData As Variant 
 
    'Get the count of all data recordsets in the current document. 
    intCount = ThisDocument.DataRecordsets.Count 
 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
 
    'Get the row IDs of all the rows in the data recordset 
    lngRowIDs = vsoDataRecordset.GetDataRowIDs("") 
 
    'Iterate through all the records in the data recordset. 
    For lngRow = LBound(lngRowIDs) To UBound(lngRowIDs) + 1 
        varRowData = vsoDataRecordset.GetRowData(lngRow) 
 
        'Print a separator between rows 
        Debug.Print "------------------------------" 
 
       'Print the data stored in each column of a particular data row. 
        For lngColumn = LBound(varRowData) To UBound(varRowData) 
            Debug.Print varRowData(lngColumn) 
        Next lngColumn 
    Next lngRow 
 
End Sub

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.