NamedRange.Rows – vlastnost

Článek
01/03/2014

Získá Microsoft.Office.Interop.Excel.Range , který představuje jeden nebo více řádků v NamedRange ovládacího prvku.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
ReadOnly Property Rows As Range

Range Rows { get; }

Hodnota vlastnosti

Typ: Microsoft.Office.Interop.Excel.Range
A Microsoft.Office.Interop.Excel.Range , který představuje jeden nebo více řádků v NamedRange ovládacího prvku.

Poznámky

Při použití bez parametrů, vrátí tato vlastnost Range objekt, který obsahuje všechny řádky v pojmenované oblasti.

Tuto vlastnost lze použít s následující volitelné parametry, chcete-li získat určité řádky v pojmenované oblasti.Pokud tuto vlastnost použít s parametry, vrácená hodnota je objekt, který musíte přetypovat Range.

Parametr	Description
RowIndex	Index získat jeden nebo více řádků. Chcete-li získat jeden řádek, předáte celé číslo, které určuje index řádku, který chcete načíst.Indexy řádek začíná 1. Chcete-li získat více sousedících řádků, předat řetězec ve formátu "first row:last row".Chcete-li získat řádky 1 až 5, například předáte "1:5".
ColumnIndex	Nepoužívejte tento parametr.Tato vlastnost vyvolá COMException Pokud se pokusíte předat hodnotu tohoto parametru.

RowIndex

Index získat jeden nebo více řádků.

Chcete-li získat jeden řádek, předáte celé číslo, které určuje index řádku, který chcete načíst.Indexy řádek začíná 1.

Chcete-li získat více sousedících řádků, předat řetězec ve formátu "first row:last row".Chcete-li získat řádky 1 až 5, například předáte "1:5".

ColumnIndex

Nepoužívejte tento parametr.Tato vlastnost vyvolá COMException Pokud se pokusíte předat hodnotu tohoto parametru.

Příklady

Následující příklad kódu vytvoří NamedRange a použije Rows vlastnost nastavit barvu, název, velikost a výraznosti písmo všechny buňky v prvních pěti řádků v oblasti.

Tento příklad je pro vlastní úpravy úrovni dokumentu.Chcete-li spustit tento kód, zkopírujte jej do jedné ze tříd listu v projektu.

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

Následující příklad kódu vytvoří NamedRange a použije Rows vlastnost k určení, kolik řádků k dispozici jsou v rozsahu.

Tento příklad je pro vlastní úpravy úrovni dokumentu.Chcete-li spustit tento kód, zkopírujte jej do jedné ze tříd listu v projektu.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

NamedRange Rozhraní

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím