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", "Bitmap", "Hyperlink", "Unicode Text" и "Text".
- 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, а затем просмотрите форматы, перечисленные в диалоговом окне Специальная вставка.
Параметр NoHTMLFormatting имеет смысл только в том случае, если параметр Format имеет значение "HTML". Во всех остальных случаях параметр NoHTMLFormatting игнорируются.
Если аргумент не задан, перед использованием данного метода необходимо выбрать диапазон назначения.
В зависимости от содержимого буфера обмена вызов этого метода может привести к изменению выделения листа.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.
Примеры
В следующем примере кода в буфер обмена помещается HTML-код, после чего используется метод PasteSpecial для вставки содержимого буфера обмена в ячейку А1. Обратите внимание на то, что в этом примере перед вызовом метода 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", missing].Select();
this.PasteSpecial(missing, false, false, missing, missing,
missing, missing);
}
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.