NamedRange.Parse, méthode

Article
08/10/2011

Analyse une plage de données et la décompose en plusieurs cellules.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function Parse ( _
    ParseLine As Object, _
    Destination As Object _
) As Object

Object Parse(
    Object ParseLine,
    Object Destination
)

Paramètres

ParseLine
Type : System.Object
Chaîne qui contient des crochets gauche et droit visant à spécifier l'emplacement au niveau duquel fractionner les cellules.
Par exemple, [xxx][xxx] insère les trois premiers caractères dans la première colonne de la plage de destination et les trois caractères suivants dans la seconde colonne.
Si cet argument est omis, Microsoft Office Excel devine où fractionner les colonnes sur la base de l'espacement de la cellule supérieure gauche de la plage.Si vous souhaitez utiliser une autre plage pour deviner la ligne de redistribution, utilisez un objet Microsoft.Office.Interop.Excel.Range comme argument ParseLine.Cette plage doit être l'une des cellules analysées.L'argument de ParseLine ne peut pas comporter plus de 255 caractères, y compris les crochets et les espaces.

Destination
Type : System.Object
Objet Microsoft.Office.Interop.Excel.Range qui représente l'angle supérieur gauche de la plage de destination des données analysées.Si cet argument est omis, Excel effectue l'analyse sur place.

Valeur de retour

Type : System.Object

Notes

Distribue le contenu du contrôle NamedRange pour remplir plusieurs colonnes adjacentes. La largeur du contrôle NamedRange ne peut pas excéder une colonne.

Exemples

L'exemple de code suivant utilise la méthode Parse pour analyser chaque groupe de chiffres dans un ensemble de numéros de téléphone se trouvant dans un contrôle NamedRange appelé NamedRange1 sous la forme d'une nouvelle plage de cellules commençant à la cellule D1.

Cet exemple illustre une personnalisation au niveau du document.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via