WorksheetBase.Columns, propriété

Article
01/06/2014

Obtient un objet Range qui représente une ou plusieurs colonnes sur la feuille de calcul.

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

Syntaxe

'Déclaration
Public ReadOnly Property Columns As Range

public Range Columns { get; }

Valeur de propriété

Type : Microsoft.Office.Interop.Excel.Range
Objet Range qui représente une ou plusieurs colonnes sur la feuille de calcul.

Notes

En cas d'utilisation sans paramètres, cette propriété retourne un objet Range qui contient toutes les colonnes sur la feuille de calcul.

Cette propriété peut être utilisée avec les paramètres optionnels suivants pour obtenir des colonnes spécifiques sur la feuille de calcul. 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 utilise la propriété Columns pour définir la couleur, le nom, la taille et le gras de la police de toutes les cellules de la première colonne de la feuille de calcul.

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 fillColumn As Excel.Range = TryCast(Me.Columns("A"), Excel.Range)

    With fillColumn.Font
        ' Set the font color to blue (RGB value FF 00 00), 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()
{
    Excel.Range fillColumn = (Excel.Range)this.Columns["A"];
    Excel.Font columnsFont = fillColumn.Font;

    // Set the font color to blue (RGB value FF 00 00), 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";
}

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

WorksheetBase Classe

Microsoft.Office.Tools.Excel, espace de noms

Partager via