NamedRange.Columns - свойство

Статья
01/10/2014

Получает объект Microsoft.Office.Interop.Excel.Range, представляющий один или несколько столбцов в элементе управления NamedRange.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)

Синтаксис

'Декларация
ReadOnly Property Columns As Range

Range Columns { get; }

Значение свойства

Тип: Microsoft.Office.Interop.Excel.Range
Объект Microsoft.Office.Interop.Excel.Range, представляющий один или несколько столбцов в элементе управления NamedRange.

Заметки

При использовании без параметров, это свойство возвращает объект Range, который содержит все столбцы в указанном диапазоне.

Это свойство может использоваться со следующими необязательными параметрами для получения определенных столбцов в именованном диапазоне. Если это свойство используется с параметрами, возвращаемое значение представляет собой объект, который должен быть приведен к типу Range.

Параметр	Описание
RowIndex	Индекс одного или нескольких получаемых столбцов. Чтобы получить один столбец, передайте один из следующих объектов в данный параметр: Целое число, указывающее индекс столбца, который требуется получить. Индексы строк начинаются с 1. Строка, состоящая из буквы столбца, который требуется получить. Чтобы получить несколько смежных столбцов, передайте строку в формате "first column letter:last column letter". Например, чтобы получить столбцы с A по E, передайте "A:E". Примечание Имя этого параметра является неправильным; этот параметр задает индексы столбцов, которые требуется получить, а не строк.
ColumnIndex	Не следует использовать данный параметр. Это свойство выдаст исключение COMException при попытке передать значение этому параметру.

RowIndex

Индекс одного или нескольких получаемых столбцов.

Чтобы получить один столбец, передайте один из следующих объектов в данный параметр:

Целое число, указывающее индекс столбца, который требуется получить. Индексы строк начинаются с 1.
Строка, состоящая из буквы столбца, который требуется получить.

Чтобы получить несколько смежных столбцов, передайте строку в формате "first column letter:last column letter". Например, чтобы получить столбцы с A по E, передайте "A:E".

Примечание

Имя этого параметра является неправильным; этот параметр задает индексы столбцов, которые требуется получить, а не строк.

ColumnIndex

Не следует использовать данный параметр. Это свойство выдаст исключение COMException при попытке передать значение этому параметру.

Примеры

В следующем примере кода создается NamedRange, а затем используется свойство Columns для задания цвета, имени, размера и жирности шрифта всех ячеек в первом столбце диапазона.

В этом примере демонстрируется настройка уровня документа. Для выполнения этого кода скопируйте его в один из классов листа в проекте.

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"];
    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 для определения количества столбцов в диапазоне.

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 Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через