Freigeben über

WorksheetBase.PasteSpecial-Methode

  • Artikel

Fügt den Inhalt der Zwischenablage mit einem angegebenen Format in das Arbeitsblatt ein.Verwenden Sie diese Methode, um Daten aus anderen Anwendungen einzufügen oder um Daten eines bestimmten Formats einzufügen.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
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
)

Parameter

  • format
    Typ: System.Object
    Eine Zeichenfolge, die das Format für die Zwischenablage der Daten angibt.Allgemeine Formatzeichenfolgen schließen "HTML", "Bitmap", "Link", "Unicode Text" und "Text" ein.
  • link
    Typ: System.Object
    true , um einen Link zur Quelle der eingefügten Daten zu erstellen.Dieser Parameter wird ignoriert, wenn die Quelldaten nicht zum Verknüpfen geeignet sind oder die Quellanwendung keine Verknüpfungen unterstützt.Der Standardwert ist false.
  • displayAsIcon
    Typ: System.Object
    true , um das eingefügte Objekt als Symbol anzuzeigen.Der Standardwert ist false.
  • iconFileName
    Typ: System.Object
    Der Name der Datei mit dem Symbol, das verwendet werden soll, wenn DisplayAsIcontrue ist.
  • iconIndex
    Typ: System.Object
    Die Indexnummer des Symbols in der Symboldatei.
  • noHTMLFormatting
    Typ: System.Object
    true , um alle Formatierungen, Links und Bilder aus HTML zu entfernen; false, um HTML unverändert einzufügen.Der Standardwert ist false.

Hinweise

Wenn Sie nicht wissen, welche Zeichenfolge an den Format-Parameter übergeben werden soll, können Sie die Zeichenfolgen anzeigen, die mit den Daten in der Zwischenablage kompatibel sind, indem Sie den Einfügen-Befehl in Excel verwenden.Kopieren Sie die Daten in die Zwischenablage, verwenden Sie den Befehl Inhalte einfügen in Excel, und zeigen Sie dann die im Dialogfeld Inhalte einfügen aufgeführten Formate an.

NoHTMLFormatting ist nur von Bedeutung, wenn Format = "HTML" ist.In allen anderen Fällen wird NoHTMLFormatting ignoriert.

Bevor Sie diese Methode verwenden, müssen Sie den Zielbereich markieren.

Die Methode ändert möglicherweise die Blattauswahl; dies hängt vom Inhalt der Zwischenablage ab.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird HTML in der Zwischenablage abgelegt. Anschließend wird die PasteSpecial-Methode verwendet, um den Inhalt der Zwischenablage in die Zelle A1 einzufügen.Beachten Sie, dass im Beispiel die Auswahl des Bereichs vor dem Aufruf der PasteSpecial-Methode erfolgt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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-Sicherheit

Siehe auch

Referenz

WorksheetBase Klasse

Microsoft.Office.Tools.Excel-Namespace