通过

NamedRange.Characters 属性

  • 项目

获取一个 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
    Get

NamedRange_CharactersType Characters { get; }

属性值

类型：Microsoft.Office.Tools.Excel.NamedRange_CharactersType
一个 Microsoft.Office.Interop.Excel.Characters 对象，表示 NamedRange 控件文本中某一范围的字符。

备注

Characters 属性旨在与下列参数一起使用。

Parameter

说明

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

此版本针对的是应用程序级外接程序。

Private charactersRange As NamedRange

Private Sub FormatCharacters()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet

    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)

    charactersRange = vstoWorksheet.Controls.AddNamedRange( _
        vstoWorksheet.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

NamedRange charactersRange;
private void FormatCharacters()
{
    Worksheet vstoWorksheet =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]); ;
    charactersRange = vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A1", "A1"], "charactersRange");
    charactersRange.Value2 = "Smith";
    charactersRange.Characters[1, 1].Font.Bold = true;
    charactersRange.Characters[1, 1].Font.Size = 14;
}

.NET Framework 安全性

请参见

参考

NamedRange 接口

Microsoft.Office.Tools.Excel 命名空间