NamedRange.Parse(Object, Object) Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Analisa um intervalo de dados e o divide em várias células.

public object Parse (object ParseLine, object Destination);

abstract member Parse : obj * obj -> obj

Public Function Parse (Optional ParseLine As Object, Optional Destination As Object) As Object

Parâmetros

ParseLine: Object

Uma cadeia de caracteres que contém colchetes esquerdos e direitos para indicar o local em que as células devem ser divididas. Por exemplo, "[xxx][xxx]" inseriria os três primeiros caracteres na primeira coluna do intervalo de destino, bem como os próximos três caracteres na segunda coluna. Se esse argumento for omitido, o Microsoft Office Excel adivinhará onde dividir as colunas baseadas 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 Range objeto como o ParseLine argumento . Esse intervalo deve ser uma das células que está sendo analisada. O ParseLine argumento não pode ter mais de 255 caracteres, incluindo os colchetes e espaços.

Destination: Object

Um objeto Range que representa o canto superior esquerdo do intervalo de destino para os dados analisados. Se esse argumento for omitido, o Excel fará a análise no local.

Retornos

Object

Exemplos

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

Este exemplo destina-se a uma personalização no nível de documento.

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"]);
}

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

Comentários

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

Aplica-se a

Compartilhar via