مشاركة عبر

NamedRange.Rows الخاصية

  • مقالة

يحصل Microsoft.Office.Interop.Excel.Rangeالذي يمثل صف واحد أو أكثر في NamedRangeعنصر تحكم.

مساحة الاسم:  Microsoft.Office.Tools.Excel
التجميع:  Microsoft.Office.Tools.Excel (في Microsoft.Office.Tools.Excel.dll)

بناء الجملة

'إقرار
ReadOnly Property Rows As Range
    Get

Range Rows { get; }

قيمة الخاصية

النوع: Microsoft.Office.Interop.Excel.Range
Microsoft.Office.Interop.Excel.Rangeالذي يمثل واحد أو المزيد صفوف في NamedRangeعنصر التحكم.

ملاحظات

عند استخدامه بدون معلمات, هذه خاصية بإرجاع Rangeالكائن الذي يحتوي على الجميع صفوف الموجودة في النطاق المسمى.

يمكن استخدام هذه خاصية مع المعلمات الاختيارية التالية إلى يحصل محدد صفوف الموجودة في النطاق المسمى. إذا كنت تستخدم th هو خاصية مع معلمات، الالقيمة المرجعة هو كائن يجب أن يتم تحويل إلى Range.

المعلمة

الوصف

RowIndex

فهرس صف واحد أو أكثر إلى يحصل.

إلى يحصل صف مفرد، تمرير عدد صحيح يحدد رقم الصف الذي تريده إلى يحصل. تبدأ الفهارس الصف رقم 1.

إلى يحصل عدة صفوف متجاورة، تمرير سلسلة أحرف بالتنسيق " first row: last row". على سبيل المثال، للحصول على صفوف من 1 إلى 5، مرر "1: 5".

ColumnIndex

لا استخدم هذه معلمة. سيتم طرح هذه خاصية COMExceptionإذا حاولت إلى تمرير القيمة إلى هذه معلمة.

أمثلة

يلي تعليمات برمجية المثال، يتم إنشاء NamedRangeثم يستخدم Rowsخاصية لتعيين اللون، الاسم والحجم، و boldness خط لكافة خلايا في صفوف الخمسة الأولى في النطاق.

Th هو المثال هو لتخصيص المستوى مستند. لتشغيل هذه تعليمات برمجية، قم بنسخ إلى واحد الفئات ورقة عمل في مشروع.

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

مثال التعليمة البرمجية التالية ينشئ NamedRangeثم يستخدم Rowsخاصية لتحديد عدد صفوف التي توجد في النطاق.

Th هو المثال هو لتخصيص المستوى مستند. لتشغيل هذه تعليمات برمجية، قم بنسخ إلى واحد الفئات ورقة عمل في مشروع.

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.

راجع أيضًَا

المرجع

NamedRange واجهة

NamedRange الأعضاء

Microsoft.Office.Tools.Excel مساحة الاسم