Clipboard Clase

Definición

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
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 formatos predefinidos disponibles para su uso con la Clipboard clase , vea 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.

  • En copiar o cortar, el código de confianza parcial coloca texto no cifrado y lenguaje xaml (XAML) en el Portapapeles. Texto sin formato incluye texto, texto Unicode, texto OEM (modelo de intercambio de objetos) y CSV (valores separados por comas).

  • Al pegar, Windows Presentation Foundation (WPF) pegará en Lenguaje de marcado de aplicación extensible (XAML) si el origen de ese contenido es de un sitio de confianza igual o más de confianza. Concretamente:

    • 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 que no sea de Windows Presentation Foundation (WPF) puede examinar el formato ApplicationTrust en el Portapapeles y sanear el XAML si procede.

Métodos

Clear()

Borra los datos del Portapapeles del sistema.

ContainsAudio()

Consulta la presencia de datos en el Portapapeles con el formato de datos de WaveAudio.

ContainsData(String)

Consulta la presencia de datos con un formato de datos especificado en el Portapapeles.

ContainsFileDropList()

Consulta la presencia de datos en el Portapapeles con el formato de datos de FileDrop.

ContainsImage()

Consulta la presencia de datos en el Portapapeles con el formato de datos de Bitmap.

ContainsText()

Consulta la presencia de datos en el Portapapeles con el formato de UnicodeText.

ContainsText(TextDataFormat)

Consulta la presencia de datos con un formato de datos de texto en el Portapapeles.

Flush()

Agrega permanentemente los datos que están en Clipboard de modo que estén disponibles después de cerrarse la aplicación original de los datos.

GetAudioStream()

Devuelve un flujo de datos del Portapapeles con el formato de datos de WaveAudio.

GetData(String)

Recupera los datos con un formato especificado desde el 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 los archivos colocados disponible en el Portapapeles.

GetImage()

Devuelve un objeto BitmapSource del Portapapeles que contiene los datos con el formato de Bitmap.

GetText()

Devuelve una cadena que contiene los datos de UnicodeText del Portapapeles.

GetText(TextDataFormat)

Devuelve una cadena que contiene los datos de texto del Portapapeles.

IsCurrent(IDataObject)

Compara un objeto de datos especificado con el contenido del Portapapeles.

SetAudio(Byte[])

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

SetAudio(Stream)

Almacena los datos de audio (formato de datos de WaveAudio ) en el Portapapeles. Los datos de audio se especifican como secuencia.

SetData(String, Object)

Almacena los datos especificados en el Portapapeles con el formato especificado.

SetDataObject(Object)

Coloca un objeto de datos no persistente especificado en el Portapapeles del sistema.

SetDataObject(Object, Boolean)

Coloca un objeto de datos especificado en el Portapapeles del sistema y acepta un parámetro de tipo booleano que indica si el objeto de datos se debe quedar en el Portapapeles al salir de la aplicación.

SetFileDropList(StringCollection)

Almacena los datos de FileDrop en el Portapapeles. La lista de archivos colocada se especifica como colección de cadenas.

SetImage(BitmapSource)

Almacena los datos de Bitmap en el Portapapeles. Los datos de la imagen se especifican como BitmapSource.

SetText(String)

Almacena los datos de UnicodeText en el Portapapeles.

SetText(String, TextDataFormat)

Almacena los datos de texto en el Portapapeles con un formato de datos de texto especificado. Los datos de UnicodeText que se van a almacenar se especifican como cadena.

Se aplica a

Consulte también