NamedRange.Rows プロパティ
NamedRange コントロール内の 1 つ以上の行を表す Microsoft.Office.Interop.Excel.Range を取得します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
ReadOnly Property Rows As Range
Range Rows { get; }
プロパティ値
型 : Microsoft.Office.Interop.Excel.Range
NamedRange コントロール内の 1 つ以上の列を表す Microsoft.Office.Interop.Excel.Range。
解説
このプロパティは、パラメーターなしで使用されるとき、名前付き範囲内のすべての行を含む Range オブジェクトを返します。
このプロパティは、次の省略可能なパラメーターで名前付き範囲の特定の行を取得するために使用できます。パラメーターを指定してこのプロパティを使用する場合、戻り値は、Range にキャストする必要があるオブジェクトです。
パラメーター |
説明 |
|---|---|
RowIndex |
取得する 1 つ以上の行のインデックス。 1 つの行を取得するには、取得する行のインデックスを指定する整数を渡します。行インデックスは 1 から開始します。 連続した複数の行を取得するには、"first row:last row" という形式の文字列を渡します。たとえば、行 1 ～ 5 を取得するには、"1:5" を渡します。 |
ColumnIndex |
このパラメーターは使用しないでください。このパラメーターに値を渡そうとすると、このプロパティは COMException をスローします。 |
例
次のコード例は、NamedRange を作成し、Rows プロパティを使用して、範囲内の最初の 5 つの列のすべてのセルのフォントの色、名前、サイズ、太字の濃さを設定します。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。このコードを実行するには、プロジェクト内のワークシート クラスの 1 つにコピーします。
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";
}
次のコード例は、NamedRange を作成し、Rows プロパティを使用して、範囲内に存在する行の数を判断します。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。このコードを実行するには、プロジェクト内のワークシート クラスの 1 つにコピーします。
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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。