NamedRange.Parse (Método)
Analiza un rango de datos y lo divide en varias celdas.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Function Parse ( _
ParseLine As Object, _
Destination As Object _
) As Object
Object Parse(
Object ParseLine,
Object Destination
)
Parámetros
- ParseLine
Tipo: System.Object
Cadena que contiene corchetes a la izquierda y a la derecha para indicar por dónde deben dividirse las celdas.
Por ejemplo, "[xxx][xxx]" insertaría los tres primeros caracteres en la primera columna del rango de destino, y los tres caracteres siguientes en la segunda columna.
Si se omite este argumento, Microsoft Office Excel estima dónde debe dividir las columnas a partir del espaciado de la celda superior izquierda del rango.Si desea utilizar un rango diferente para la estimación de la línea de redistribución, utilice un objeto Microsoft.Office.Interop.Excel.Range como argumento de ParseLine.Dicho rango debe ser una de las celdas que se analizan.El argumento ParseLine no puede tener más de 255 caracteres, contando los corchetes y los espacios.
- Destination
Tipo: System.Object
Objeto Microsoft.Office.Interop.Excel.Range que representa la esquina superior izquierda del rango de destino de los datos analizados.Si se omite este argumento, Excel analiza los datos en la misma posición.
Valor devuelto
Tipo: System.Object
Comentarios
Distribuye el contenido del control NamedRange para rellenar varias columnas adyacentes. El control NamedRange sólo puede tener el ancho de una columna.
Ejemplos
En el siguiente ejemplo de código se usa el método Parse para analizar cada grupo de dígitos en un conjunto de números de teléfono a partir de un control NamedRange denominado NamedRange1 en un nuevo rango de celdas que empiezan en la celda D1.
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub ParsePhoneNumbers()
Me.Range("A1").Value2 = "'5555550100'"
Me.Range("A2").Value2 = "'2065550101'"
Me.Range("A3").Value2 = "'4255550102'"
Me.Range("A4").Value2 = "'4155550103'"
Me.Range("A5").Value2 = "'5105550104'"
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
"namedRange1")
' Parse the phone numbers and insert them into
' the range starting at D1.
namedRange1.Parse("[XXX][XXX][XXXX]", Me.Range("D1"))
End Sub
private void ParsePhoneNumbers()
{
this.Range["A1", missing].Value2 = "'5555550100'";
this.Range["A2", missing].Value2 = "'2065550101'";
this.Range["A3", missing].Value2 = "'4255550102'";
this.Range["A4", missing].Value2 = "'4155550103'";
this.Range["A5", missing].Value2 = "'5105550104'";
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", "A5"],
"namedRange1");
// Parse the phone numbers and insert them into
// the range starting at D1.
namedRange1.Parse("[XXX][XXX][XXXX]",
this.Range["D1", missing]);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.