NamedRange.Rows-Eigenschaft

Artikel
08/10/2011

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

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property Rows As Range
    Get

Range Rows { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Excel.Range
Ein Microsoft.Office.Interop.Excel.Range-Element ab, das eine oder mehr Zeilen im NamedRange-Steuerelement darstellt.

Hinweise

Wenn sie ohne Parameter verwendet wird, gibt diese Eigenschaft 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 abzurufen. Wenn Sie diese Eigenschaft mit Parametern verwenden, ist der Rückgabewert ein Objekt, das in einen Range umgewandelt werden muss.

Parameter	Beschreibungen
RowIndex	Der Index einer oder mehrerer Zeilen, die abgerufen werden sollen. Um eine einzelne Zeile abzurufen, übergeben Sie eine ganze Zahl, die den Index der Zeile angibt, die Sie abrufen möchten. Die Zeilenindizes beginnen bei 1. Um mehrere zusammenhängende Zeilen abzurufen, übergeben Sie eine Zeichenfolge mit dem Format "first row:last row". Um z.B. die Zeilen 1 bis 5 abzurufen, übergeben Sie "1:5".
ColumnIndex	Verwenden Sie diesen Parameter nicht. Diese Eigenschaft löst eine COMException aus, wenn Sie versuchen, einen Wert an diesen Parameter zu übergeben.

RowIndex

Der Index einer oder mehrerer Zeilen, die abgerufen werden sollen.

Um eine einzelne Zeile abzurufen, übergeben Sie eine ganze Zahl, die den Index der Zeile angibt, die Sie abrufen möchten. Die Zeilenindizes beginnen bei 1.

Um mehrere zusammenhängende Zeilen abzurufen, übergeben Sie eine Zeichenfolge mit dem Format "first row:last row". Um z.B. die Zeilen 1 bis 5 abzurufen, übergeben Sie "1:5".

ColumnIndex

Verwenden Sie diesen Parameter nicht. Diese Eigenschaft löst eine COMException aus, wenn Sie versuchen, einen Wert an diesen Parameter zu übergeben.

Beispiele

Im folgenden Codebeispiel wird ein NamedRange erstellt und anschließend mit der Rows-Eigenschaft die Farbe, der Name, der Schriftgrad und die Fettformatierung der Schriftart für alle Zellen in den ersten 5 Zeilen des Bereichs festgelegt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene. Wenn Sie diesen Code ausführen möchten, kopieren Sie ihn in eine der Arbeitsblattklassen im Projekt.

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", missing];
    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";
}

Im folgenden Codebeispiel wird ein NamedRange erstellt und anschließend mit der Rows-Eigenschaft ermittelt, wie viele Zeilen sich im Bereich befinden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene. Wenn Sie diesen Code ausführen möchten, kopieren Sie ihn in eine der Arbeitsblattklassen im Projekt.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via