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

Статья
05/19/2013

Возвращает объект Microsoft.Office.Interop.Excel.Characters, представляющий диапазон символов в тексте элемента управления NamedRange.

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

Синтаксис

'Декларация
ReadOnly Property Characters As NamedRange_CharactersType

NamedRange_CharactersType Characters { get; }

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

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

Заметки

Свойство Characters должно использоваться с указанными ниже параметрами.

Параметр	Описание
Start	Первый возвращаемый символ.Если этот аргумент не указан или имеет значение 1, данное свойство возвращает диапазон символов, начиная с первого символа.
Length	Число возвращаемых символов.Если этот аргумент не указан, данное свойство возвращает оставшуюся часть строки (все, что находится после символа Start).

При попытке использования свойства Characters без указания каких-либо параметров свойство Characters получит объект NamedRange_CharactersType, который является частью инфраструктуры Visual Studio и не предназначен для использования непосредственно из кода.

ОбъектMicrosoft.Office.Interop.Excel.Characters можно использовать для форматирования символов в текстовой строке.Объект Microsoft.Office.Interop.Excel.Characters не является коллекцией.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода создается объект NamedRange, который заполняется словом «Smith».После этого первый символ в слове изменяется: он выделяется полужирным шрифтом, а его размер становится равен 14.

Эта версия предназначена для настройки уровня документа.

Private charactersRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub FormatCharacters()
    charactersRange = Me.Controls.AddNamedRange( _
        Me.Range("A1", "A1"), "charactersRange")
    Me.charactersRange.Value2 = "Smith"
    Me.charactersRange.Characters(1, 1).Font.Bold = True
    Me.charactersRange.Characters(1, 1).Font.Size = 14
End Sub

Microsoft.Office.Tools.Excel.NamedRange charactersRange;
private void FormatCharacters()
{
    charactersRange = this.Controls.AddNamedRange(
        this.Range["A1", "A1"], "charactersRange");
    this.charactersRange.Value2 = "Smith";
    this.charactersRange.Characters[1, 1].Font.Bold = true;
    this.charactersRange.Characters[1, 1].Font.Size = 14;
}

Эта версия предназначена для надстройки уровня приложения.

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

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

См. также

Ссылки

NamedRange Интерфейс

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

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