Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

Clipboard (Clase)

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

System.Object
  System.Windows.Clipboard

Espacio de nombres:  System.Windows
Ensamblado:  PresentationCore (en PresentationCore.dll)

public static class Clipboard

El tipo Clipboard expone los siguientes miembros.

  NombreDescripción
Método públicoMiembro estáticoClearBorra los datos del Portapapeles del sistema.
Método públicoMiembro estáticoContainsAudioConsulta la presencia de datos en el Portapapeles con el formato de datos de WaveAudio.
Método públicoMiembro estáticoContainsDataConsulta la presencia de datos con un formato de datos especificado en el Portapapeles.
Método públicoMiembro estáticoContainsFileDropListConsulta la presencia de datos en el Portapapeles con el formato de datos FileDrop.
Método públicoMiembro estáticoContainsImageConsulta la presencia de datos en el Portapapeles con el formato de datos de Bitmap.
Método públicoMiembro estáticoContainsText()Consulta la presencia de datos en el Portapapeles con el formato de UnicodeText.
Método públicoMiembro estáticoContainsText(TextDataFormat)Consulta la presencia de datos con un formato de datos de texto en el Portapapeles.
Método públicoMiembro estáticoGetAudioStreamDevuelve un flujo de datos del Portapapeles con el formato de datos de WaveAudio.
Método públicoMiembro estáticoGetDataRecupera los datos con un formato especificado desde el Portapapeles.
Método públicoMiembro estáticoGetDataObjectDevuelve un objeto de datos que representa todo el contenido del Portapapeles.
Método públicoMiembro estáticoGetFileDropListDevuelve una colección de cadenas que contiene una lista de los archivos colocados disponible en el Portapapeles.
Método públicoMiembro estáticoGetImageDevuelve un objeto BitmapSource del Portapapeles que contiene los datos con el formato de Bitmap.
Método públicoMiembro estáticoGetText()Devuelve una cadena que contiene los datos de UnicodeText del Portapapeles.
Método públicoMiembro estáticoGetText(TextDataFormat)Devuelve una cadena que contiene los datos de texto del Portapapeles.
Método públicoMiembro estáticoIsCurrentCompara un objeto de datos especificado con el contenido del Portapapeles.
Método públicoMiembro estáticoSetAudio(Byte[])Almacena los datos de audio (formato de datos de WaveAudio ) en el Portapapeles. Los datos de audio se especifican como matriz de bytes.
Método públicoMiembro estáticoSetAudio(Stream)Almacena los datos de audio (formato de datos de WaveAudio ) en el Portapapeles. Los datos de audio se especifican como secuencia.
Método públicoMiembro estáticoSetDataAlmacena los datos especificados en el Portapapeles con el formato especificado.
Método públicoMiembro estáticoSetDataObject(Object)Coloca un objeto de datos no persistente especificado en el Portapapeles del sistema.
Método públicoMiembro estáticoSetDataObject(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.
Método públicoMiembro estáticoSetFileDropListAlmacena los datos de FileDrop en el Portapapeles. La lista de archivos colocada se especifica como colección de cadenas.
Método públicoMiembro estáticoSetImageAlmacena los datos de Bitmap en el Portapapeles. Los datos de la imagen se especifican como BitmapSource.
Método públicoMiembro estáticoSetText(String)Almacena los datos de UnicodeText en el Portapapeles.
Método públicoMiembro estáticoSetText(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.
Arriba

Todas las aplicaciones de Windows comparten el Portapapeles del sistema, por lo que el contenido del mismo está sujeto a modificaciones cuando se cambia a otra aplicación.

Para obtener una lista de los formatos predefinidos disponibles que se usan con la clase Clipboard, vea la clase DataFormats.

Alerta de seguridad: Por razones de seguridad, se deben tener en cuenta los puntos siguientes.

  • Las operaciones de pegado las debe iniciar el usuario (Ctrl-V, menú Pegar).

  • Sólo puede hacerse la copia del contenido seleccionado por el usuario

  • Al copiar o cortar, el código de confianza parcial coloca el texto Extensible Application Markup Language (XAML) y sin formato en el portapapeles. El 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 Extensible Application Markup Language (XAML) si el origen de ese contenido es de un sitio tanto de confianza como de más confianza. De manera específica:

    • 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 puede pegar XAML sólo desde otra aplicación de plena confianza.

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

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);


.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Mostrar: