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
图标文件中该图标的索引号。
- iconLabel
类型: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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。