Método NamedRange.Parse

Artigo
08/01/2011

Analisa um intervalo de dados e as divide em várias 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 seqüência de caracteres contendo colchetes esquerdos e direito para indicar onde as células devem ser divididas.
Por exemplo, "[xxx][xxx]" inseriria os três primeiros caracteres na primeira coluna do intervalo de destino e insere os próximos três caracteres na segunda coluna.
Se esse argumento for omitido, o Excel de Microsoft Office "adivinhará" onde dividir as colunas com base no espaçamento da célula superior esquerda no intervalo.Se você quiser usar um intervalo diferente para adivinhar a linha de análise, use um Microsoft.Office.Interop.Excel.Range de objeto como a ParseLine argumento.O intervalo precisa ser uma das células que está sendo analisado.O ParseLine argumento não pode ser mais de 255 caracteres, incluindo os colchetes e espaços.

Destination
Tipo: System.Object
A Microsoft.Office.Interop.Excel.Range objeto que representa o canto superior esquerdo do intervalo de destino para os dados analisados.Se esse argumento for omitido, o Excel analisará in loco.

Valor de retorno

Tipo: System.Object

Comentários

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

Exemplos

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

Este exemplo é para uma personalização em nível de 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]);
}

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