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


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

См. также

Ссылки

WorksheetBase Класс

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