NamedRange.Columns, propriété

Article
01/06/2014

Obtient un Microsoft.Office.Interop.Excel.Range qui représente une ou plusieurs colonnes du contrôle NamedRange.

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

Syntaxe

'Déclaration
ReadOnly Property Columns As Range

Range Columns { get; }

Valeur de propriété

Type : Microsoft.Office.Interop.Excel.Range
Microsoft.Office.Interop.Excel.Range qui représente une ou plusieurs colonnes du contrôle NamedRange.

Notes

En cas d'utilisation sans paramètres, cette propriété retourne un objet Range qui contient toutes les colonnes dans la plage nommée.

Cette propriété peut être utilisée avec les paramètres optionnels suivants pour obtenir des colonnes spécifiques dans la plage nommée. Si vous utilisez cette propriété avec les paramètres, la valeur de retour est un objet qui doit être casté en un Range.

Paramètre	Description
RowIndex	Index d'une ou plusieurs colonnes à obtenir. Pour obtenir une colonne unique, passez l'un des objets suivants à ce paramètre : Entier qui spécifie l'index de la colonne que vous souhaitez obtenir. Les index de colonne commencent à 1. Chaîne qui se compose de la lettre de la colonne que vous souhaitez obtenir. Pour obtenir plusieurs colonnes contiguës, passez une chaîne au format "first column letter:last column letter". Par exemple, pour obtenir les colonnes A à E, passez « A:E ». Remarque Le nom de ce paramètre est trompeur ; ce paramètre spécifie les index des colonnes que vous voulez obtenir, pas les lignes.
ColumnIndex	N'utilisez pas ce paramètre. Cette propriété lèvera un COMException si vous essayez de passer une valeur à ce paramètre.

RowIndex

Index d'une ou plusieurs colonnes à obtenir.

Pour obtenir une colonne unique, passez l'un des objets suivants à ce paramètre :

Entier qui spécifie l'index de la colonne que vous souhaitez obtenir. Les index de colonne commencent à 1.
Chaîne qui se compose de la lettre de la colonne que vous souhaitez obtenir.

Pour obtenir plusieurs colonnes contiguës, passez une chaîne au format "first column letter:last column letter". Par exemple, pour obtenir les colonnes A à E, passez « A:E ».

Remarque

Le nom de ce paramètre est trompeur ; ce paramètre spécifie les index des colonnes que vous voulez obtenir, pas les lignes.

ColumnIndex

N'utilisez pas ce paramètre. Cette propriété lèvera un COMException si vous essayez de passer une valeur à ce paramètre.

Exemples

L'exemple de code suivant crée un NamedRange puis utilise la propriété Columns pour définir la couleur, le nom, la taille et le gras de la police de toutes les cellules dans la première colonne de la plage.

Cet exemple illustre une personnalisation au niveau du document. Pour exécuter ce code, copiez-le dans l'une des classes de feuille de calcul dans votre projet.

Private Sub SetFirstColumnFont()
    Dim testRange As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A1", "J10"), _
        "TestRange")
    testRange.Select()

    Dim fillColumn As Excel.Range = TryCast(testRange.Columns("A"), Excel.Range)
    With fillColumn.Font
        ' Set the font color to blue (RGB value 00 00 FF), and set other font properties.
        .Color = &HFF0000
        .Name = "Arial"
        .Size = 14
        .Bold = False
    End With

    ' Test the changes by writing a value to all the column cells.
    fillColumn.Value2 = "This is a test"
End Sub

private void SetFirstColumnFont()
{
    Microsoft.Office.Tools.Excel.NamedRange testRange = 
        this.Controls.AddNamedRange(this.Range["A1", "J10"],
        "TestRange");
    testRange.Select();

    Excel.Range fillColumn = (Excel.Range)testRange.Columns["A"];
    Excel.Font columnsFont = fillColumn.Font;

    // Set the font color to blue (RGB value 00 00 FF), and set other font properties.
    columnsFont.Color = 0xFF0000;
    columnsFont.Name = "Arial";
    columnsFont.Size = 14;
    columnsFont.Bold = false;

    // Test the changes by writing a value to all the column cells.
    fillColumn.Value2 = "This is a test";
}

L'exemple de code suivant crée un NamedRange puis utilise la propriété Columns pour déterminer combien de colonnes il y a dans la plage.

Cet exemple illustre une personnalisation au niveau du document. Pour exécuter ce code, copiez-le dans l'une des classes de feuille de calcul dans votre projet.

Private compositeRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub DisplayRangeComposition()
    compositeRange = Me.Controls.AddNamedRange( _
        Me.Range("B2", "E5"), "compositeRange")
    compositeRange.Cells.Interior.Color = &HFF00
    MessageBox.Show("The range has " & _
        compositeRange.Count & " cells.")
    MessageBox.Show("The range has " & _
        compositeRange.Columns.Count & " columns.")
    MessageBox.Show("The range has " & _
        compositeRange.Rows.Count & " rows.")
End Sub

Microsoft.Office.Tools.Excel.NamedRange compositeRange;
private void DisplayRangeComposition()
{
    compositeRange = this.Controls.AddNamedRange(
        this.Range["B2", "E5"], "compositeRange");
    compositeRange.Cells.Interior.Color = 0xFF00;
    MessageBox.Show("The range has " + compositeRange.Count + 
        " cells.");
    MessageBox.Show("The range has " + 
        compositeRange.Columns.Count + " columns.");
    MessageBox.Show("The range has " + 
        compositeRange.Rows.Count + " rows.");
}

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