NamedRange.Columns الخاصية

مقالة
09/21/2010

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

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

بناء الجملة

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

Range Columns { get; }

قيمة الخاصية

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

ملاحظات

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

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

المعلمة	الوصف
RowIndex	فهرس عمود واحد أو أكثر إلى يحصل. إلى الحصول على عمود مفرد، قم بتمرير أحد الكائنات التالية إلى هذه معلمة: عدد صحيح يحدد رقم العمود الذي تريده إلى يحصل. عمود الفهارس التي تبدأ في 1. سلسلة تتكون من حرف العمود الذي تريد إلى يحصل. إلى الحصول على عدة أعمدة متجاورة، تمرير سلسلة أحرف بالتنسيق " first column letter: last column letter". على سبيل المثال، إلى الحصول على أعمدة من A حتى E، تمرير "A:E". ملاحظة اسم th هو معلمة هو mهوleading؛ th هو تعين معلمة فهارس أعمدة التي ترغب في يحصل صفوف التي لا.
ColumnIndex	لا استخدم هذه معلمة. سيتم طرح هذه خاصية COMExceptionإذا حاولت إلى تمرير القيمة إلى هذه معلمة.

RowIndex

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

إلى الحصول على عمود مفرد، قم بتمرير أحد الكائنات التالية إلى هذه معلمة:

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

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

ملاحظة

اسم th هو معلمة هو mهوleading؛ th هو تعين معلمة فهارس أعمدة التي ترغب في يحصل صفوف التي لا.

ColumnIndex

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

أمثلة

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

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

Private Sub SetFirstColumnFont()
    Dim testRange As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A1", "J10"), _
        "TestRange")
    testRange.Select()

    Dim fillColumn As Excel.Range = TryCast(testRange.Columns("A"), Excel.Range)
    With fillColumn.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 column cells.
    fillColumn.Value2 = "This is a test"
End Sub

private void SetFirstColumnFont()
{
    Microsoft.Office.Tools.Excel.NamedRange testRange = 
        this.Controls.AddNamedRange(this.Range["A1", "J10"],
        "TestRange");
    testRange.Select();

    Excel.Range fillColumn = (Excel.Range)testRange.Columns["A", missing];
    Excel.Font columnsFont = fillColumn.Font;

    // Set the font color to blue (RGB value 00 00 FF), and set other font properties.
    columnsFont.Color = 0xFF0000;
    columnsFont.Name = "Arial";
    columnsFont.Size = 14;
    columnsFont.Bold = false;

    // Test the changes by writing a value to all the column cells.
    fillColumn.Value2 = "This is a test";
}

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

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 مساحة الاسم

مشاركة عبر