Método NamedRange.Parse

Artigo
01/09/2014

Analisa um intervalo de dados e quebras deles em múltiplas células.

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 direita e esqueda para indicar onde as células devem ser rachadas.
Por exemplo, “[xxx][xxx]” inseriria os primeiros três caracteres na primeira coluna do intervalo de destino, e inseriria os três caracteres seguintes na segunda coluna.
Se esse argumento é omitido, Microsoft Office Excel suponha onde dividir as colunas com base em espaçamento da célula superior esquerda 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 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 de um documento 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ável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via