共用方式為

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。

備註

如果不知道要將哪個字串傳遞至格式參數，您可以藉由嘗試 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 命名空間