WorksheetBase.PasteSpecial 方法

使用指定的格式将剪贴板的内容粘贴到工作表上。 使用此方法可粘贴来自其他应用程序的数据或以特定格式粘贴数据。

命名空间:  Microsoft.Office.Tools.Excel
程序集:  Microsoft.Office.Tools.Excel.v4.0.Utilities(在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)

语法

声明
Public Sub PasteSpecial ( _
    format As Object, _
    link As Object, _
    displayAsIcon As Object, _
    iconFileName As Object, _
    iconIndex As Object, _
    iconLabel As Object, _
    noHTMLFormatting As Object _
)
public void PasteSpecial(
    Object format,
    Object link,
    Object displayAsIcon,
    Object iconFileName,
    Object iconIndex,
    Object iconLabel,
    Object noHTMLFormatting
)

参数

  • format
    类型:System.Object
    一个字符串,指定数据的剪贴板格式。常见格式字符串包括“HTML”、“位图”、“超链接”、“Unicode 文本”和“文本”。
  • link
    类型:System.Object
    为 true 可建立指向粘贴数据的源的链接。如果源数据不适合链接或源应用程序不支持链接,则忽略此参数。默认值为 false。
  • displayAsIcon
    类型:System.Object
    为 true 可以图标形式显示粘贴的对象。默认值为 false。
  • iconFileName
    类型:System.Object
    如果 DisplayAsIcon 为 true,则为包含要使用的图标的文件的名称。
  • iconIndex
    类型:System.Object
    图标文件中该图标的索引号。
  • noHTMLFormatting
    类型:System.Object
    为 true 可从 HTML 移除所有格式设置、超链接和图像;为 false 可按原样粘贴 HTML。默认值为 false。

备注

如果不知道哪些字符串将传递给 Format 参数,您可以通过尝试在 Excel 中粘贴命令来查看与剪贴板上的数据兼容的字符串。 将数据复制到剪贴板上,在 Excel 中,使用**“选择性粘贴”,然后查看“选择性粘贴”** 对话框中列出的格式。

仅当 Format =“HTML”时,NoHTMLFormatting 才有意义。 在所有其他情况下,将忽略 NoHTMLFormatting。

必须在使用此方法之前选择目标范围。

根据剪贴板的内容的不同,此方法可能会修改表选择。

可选参数

有关可选参数的信息,请参见Office 解决方案中的可选参数

示例

下面的代码示例将 HTML 放置到剪贴板上,然后使用 PasteSpecial 方法将剪贴板的内容粘贴到单元格 A1 中。 注意,该示例在调用 PasteSpecial 方法之前选择范围。

此示例针对的是文档级自定义项。

Private Sub PasteSpecialText()
    Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" & _
        "</STRONG></BODY></HTML>")

    Me.Range("A1").Select()
    Me.PasteSpecial(Link:=False, DisplayAsIcon:=False)
End Sub
private void PasteSpecialText()
{
    Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
        "</STRONG></BODY></HTML>");

    this.Range["A1"].Select();
    this.PasteSpecial(missing, false, false);
}

.NET Framework 安全性

请参见

参考

WorksheetBase 类

Microsoft.Office.Tools.Excel 命名空间