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

Статья
08/11/2011

Получает объект Range, представляющий один или несколько столбцов на листе.

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

Синтаксис

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

public Range Columns { get; }

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

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

Заметки

При использовании без параметров, это свойство возвращает объект 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 при попытке передать значение этому параметру.

Примеры

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

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

Private Sub SetFirstColumnFont()
    Dim fillColumn As Excel.Range = TryCast(Me.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()
{
    Excel.Range fillColumn = (Excel.Range)this.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";
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

WorksheetBase Класс

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

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