NamedRange.Rows Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein Range-Element ab, das eine oder mehr Zeilen im NamedRange-Steuerelement darstellt.
public Microsoft.Office.Interop.Excel.Range Rows { get; }
Eigenschaftswert
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. |