Método NamedRange.Parse

Artigo
05/21/2013

Analisa um intervalo de dados e as quebras múltiplas células nele.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Parse ( _
    ParseLine As Object, _
    Destination As Object _
) As Object

Object Parse(
    Object ParseLine,
    Object Destination
)

Parâmetros

ParseLine
Tipo: System.Object
Uma cadeia de caracteres que contém os colchetes esquerda e direita para indicar onde as células devem ser de divisão.
Por exemplo, “[xxx][xxx]” inseriria os três primeiros caracteres na primeira coluna do intervalo de destino, e inseriria os seguintes três caracteres na segunda coluna.
Se esse argumento for omitido, Microsoft Office Excel suponha onde dividir as colunas com base em espaçamento da célula superior esquerdo do intervalo.Se você desejar usar um intervalo diferente para descobrir a linha de análise, use um objeto de Microsoft.Office.Interop.Excel.Range como o argumento de ParseLine .Esse intervalo deve ser uma das células que está sendo analisada.O argumento de ParseLine não pode ser maior de 255 caracteres, incluindo os colchetes e espaços.

Destination
Tipo: System.Object
Um objeto de Microsoft.Office.Interop.Excel.Range que representa o canto superior esquerdo do intervalo de destino para os dados analisados.Se esse argumento é omitido, o excel analisa no lugar.

Valor de retorno

Tipo: System.Object

Comentários

Distribui o conteúdo do controle de NamedRange para preencher várias colunas adjacentes.O controle de NamedRange não pode ser mais de uma coluna de largura.

Exemplos

O exemplo de código a seguir usa o método de Parse para analisar cada grupo de dígitos em um conjunto de números de telefone de um controle de NamedRange chamado NamedRange1 em um novo intervalo das células que começam na célula D1.

Este exemplo é para uma personalização da nível.

    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"].Value2 = "'5555550100'";
    this.Range["A2"].Value2 = "'2065550101'";
    this.Range["A3"].Value2 = "'4255550102'";
    this.Range["A4"].Value2 = "'4155550103'";
    this.Range["A5"].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"]);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via