NamedRange.Rows, propriété

Article
05/16/2013

Obtient un Microsoft.Office.Interop.Excel.Range qui représente une ou plusieurs lignes 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 Rows As Range

Range Rows { get; }

Valeur de propriété

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

Notes

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

Cette propriété peut être utilisée avec les paramètres optionnels suivants pour obtenir des lignes 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 lignes à obtenir. Pour obtenir une ligne unique, passez un entier qui spécifie l'index de la ligne que vous voulez obtenir.Les index de ligne débutent à 1. Pour obtenir plusieurs lignes contiguës, passez une chaîne au format "first row:last row".Par exemple, pour obtenir les lignes 1 à 5, passez « 1:5 ».
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 lignes à obtenir.

Pour obtenir une ligne unique, passez un entier qui spécifie l'index de la ligne que vous voulez obtenir.Les index de ligne débutent à 1.

Pour obtenir plusieurs lignes contiguës, passez une chaîne au format "first row:last row".Par exemple, pour obtenir les lignes 1 à 5, passez « 1:5 ».

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é Rows pour définir la couleur, le nom, la taille et le gras de la police de toutes les cellules dans les cinq premières lignes 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 SetRowsFont()
    Dim testRange As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A1", "J10"), _
        "TestRange")
    testRange.Select()

    Dim fillRows As Excel.Range = TryCast(testRange.Rows("1:5"), Excel.Range)
    With fillRows.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 row cells.
    fillRows.Value2 = "This is a test"
End Sub

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

    Excel.Range fillRows = (Excel.Range)testRange.Rows["1:5"];
    Excel.Font rowsFont = fillRows.Font;

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

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

L'exemple de code suivant crée un NamedRange puis utilise la propriété Rows pour déterminer combien de lignes 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