Clipboard Clase

Definición

Espacio de nombres:
System.Windows
Ensamblado:
PresentationCore.dll

Proporciona métodos estáticos que facilitan la transferencia de datos hacia y desde el Portapapeles del sistema.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Herencia
Object
Clipboard

Ejemplos

En el ejemplo siguiente se muestra cómo agregar datos al Portapapeles del sistema.


// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";

// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);

' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."

' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))

Comentarios

Todas las aplicaciones para Windows comparten el Portapapeles del sistema, por lo que el contenido está sujeto a cambios al cambiar a otra aplicación.

Para obtener una lista de los formatos predefinidos disponibles para su uso con la Clipboard clase , consulte la DataFormats clase .

Alerta de seguridad: Para fines de seguridad, se deben tener en cuenta los siguientes puntos.

  • Las operaciones de pegado deben iniciarse por el usuario (Ctrl-V, Menú Pegar).

  • La copia solo puede estar en el contenido seleccionado por el usuario.

  • Al copiar o cortar, el código de confianza parcial coloca texto no cifrado y lenguaje de marcado extensible de aplicaciones (XAML) en el Portapapeles. Texto sin formato incluye texto, texto Unicode, texto OEM (Object Exchange Model) y CSV (valores separados por comas).

  • Al pegar, Windows Presentation Foundation (WPF) pegará en Extensible Application Markup Language (XAML) si el origen de ese contenido es de un sitio de confianza igual o de más confianza. Specifically:

    • Una aplicación de confianza parcial puede pegar extensible Application Markup Language (XAML) desde una aplicación de plena confianza.

    • Una aplicación de confianza parcial puede pegar extensible Application Markup Language (XAML) desde una aplicación de confianza parcial.

    • Una aplicación de plena confianza solo puede pegar XAML desde otra aplicación de plena confianza.

    • Una aplicación de plena confianza no Windows Presentation Foundation (WPF) puede examinar el formato ApplicationTrust en el Portapapeles y sanear el XAML si procede.

Métodos

Nombre Description
Clear()

Borra los datos del Portapapeles del sistema.
ContainsAudio()

Consulta el Portapapeles para la presencia de datos en el WaveAudio formato de datos.
ContainsData(String)

Consulta el Portapapeles para la presencia de datos en un formato de datos especificado.
ContainsFileDropList()

Consulta el Portapapeles para la presencia de datos en el FileDrop formato de datos.
ContainsImage()

Consulta el Portapapeles para la presencia de datos en el Bitmap formato de datos.
ContainsText()

Consulta el Portapapeles para obtener la presencia de datos en el UnicodeText formato .
ContainsText(TextDataFormat)

Consulta el Portapapeles para la presencia de datos en un formato de datos de texto.
Flush()

Agrega permanentemente los datos que están en para Clipboard que esté disponible una vez que se cierre la aplicación original de los datos.
GetAudioStream()

Devuelve un flujo de datos del Portapapeles en el WaveAudio formato de datos.
GetData(String)

Recupera datos en un formato especificado del Portapapeles.
GetDataObject()

Devuelve un objeto de datos que representa todo el contenido del Portapapeles.
GetFileDropList()

Devuelve una colección de cadenas que contiene una lista de archivos quitados disponibles en el Portapapeles.
GetImage()

Devuelve un BitmapSource objeto del Portapapeles que contiene datos con el Bitmap formato .
GetText()

Devuelve una cadena que contiene los UnicodeText datos del Portapapeles.
GetText(TextDataFormat)

Devuelve una cadena que contiene datos de texto en el Portapapeles.
IsCurrent(IDataObject)

Compara un objeto de datos especificado con el contenido del Portapapeles.
SetAudio(Byte[])

Almacena datos de audio (WaveAudio formato de datos) en el Portapapeles. Los datos de audio se especifican como una matriz de bytes.
SetAudio(Stream)

Almacena datos de audio (WaveAudio formato de datos) en el Portapapeles. Los datos de audio se especifican como una secuencia.
SetData(String, Object)

Almacena los datos especificados en el Portapapeles en el formato especificado.
SetDataObject(Object, Boolean)

Coloca un objeto de datos especificado en el Portapapeles del sistema y acepta un parámetro booleano que indica si el objeto de datos debe dejarse en el Portapapeles cuando se cierra la aplicación.
SetDataObject(Object)

Coloca un objeto de datos no persistente especificado en el Portapapeles del sistema.
SetFileDropList(StringCollection)

Almacena FileDrop datos en el Portapapeles. La lista de archivos quitada se especifica como una colección de cadenas.
SetImage(BitmapSource)

Almacena Bitmap datos en el Portapapeles. Los datos de imagen se especifican como .BitmapSource
SetText(String, TextDataFormat)

Almacena datos de texto en el Portapapeles en un formato de datos de texto especificado. Los UnicodeText datos que se van a almacenar se especifican como una cadena.
SetText(String)

Almacena UnicodeText datos en el Portapapeles.

Se aplica a

Consulte también