WorksheetBase.PasteSpecial - метод

Статья
08/11/2011

Вставляет в рабочий лист содержимое буфера обмена с использованием указанного формата. Данный метод используется для вставки данных из других приложений или вставки данных в определенном формате.

Пространство имен: 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

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

См. также

Ссылки

WorksheetBase Класс

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

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