NamedRange.Rows Eigenschaft

Definition

Ruft ein Range-Element ab, das eine oder mehr Zeilen im NamedRange-Steuerelement darstellt.

public Microsoft.Office.Interop.Excel.Range Rows { get; }

Eigenschaftswert

Range

Ein Range-Element ab, das eine oder mehr Zeilen im NamedRange-Steuerelement darstellt.

Beispiele

Im folgenden Codebeispiel wird ein erstellt NamedRange und dann die- Rows Eigenschaft verwendet, um die Farbe, den Namen, die Größe und die Stärke der Schriftart aller Zellen in den ersten fünf Zeilen im Bereich festzulegen.

Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene. Um diesen Code auszuführen, kopieren Sie ihn in eine der Arbeitsblatt Klassen in Ihrem Projekt.

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

Im folgenden Codebeispiel wird ein erstellt NamedRange und dann die- Rows Eigenschaft verwendet, um zu bestimmen, wie viele Zeilen im Bereich vorhanden sind.

Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene. Um diesen Code auszuführen, kopieren Sie ihn in eine der Arbeitsblatt Klassen in Ihrem Projekt.

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

Hinweise

Wenn diese Eigenschaft ohne Parameter verwendet wird, gibt Sie ein- Range Objekt zurück, das alle Zeilen im benannten Bereich enthält.

Diese Eigenschaft kann mit den folgenden optionalen Parametern verwendet werden, um bestimmte Zeilen im benannten Bereich zu erhalten. Wenn Sie diese Eigenschaft mit Parametern verwenden, ist der Rückgabewert ein Objekt, das in einen umgewandelt werden muss Range .

Parameter Beschreibung
RowIndex Der Index von mindestens einer Zeile, die erhalten werden soll.

Um eine einzelne Zeile zu erhalten, übergeben Sie eine ganze Zahl, die den Index der abzurufenden Zeile angibt. Die Zeilen Indizes beginnen bei 1.

Um mehrere zusammenhängende Zeilen zu erhalten, übergeben Sie eine Zeichenfolge mit dem Format " first row : last row ". Um z. b. die Zeilen 1 bis 5 zu erhalten, übergeben Sie "1:5".
ColumnIndex Verwenden Sie diesen Parameter nicht. Diese Eigenschaft löst eine aus COMException , wenn Sie versuchen, einen Wert an diesen Parameter zu übergeben.

Gilt für