Clipboard Clase

Definición

Proporciona métodos estáticos que facilitan la transferencia de datos hacia y desde el Portapapeles del sistema+.Provides static methods that facilitate transferring data to and from the system Clipboard.

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.The following example shows how to add data to the system Clipboard.


// 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 WindowsWindows comparten el Portapapeles del sistema, por lo que el contenido está sujeto a cambios al cambiar a otra aplicación.All applications for WindowsWindows share the system Clipboard, so the contents are subject to change when you switch to another application.

Para obtener una lista de los formatos predefinidos disponibles para usarlos con la Clipboard clase, vea la DataFormats clase.For a list of predefined formats available to use with the Clipboard class, see the DataFormats class.

Alerta de seguridad: Por motivos de seguridad, deben tenerse en cuenta los siguientes puntos.Security Alert: For security purposes, the following points should be kept in mind.

  • Las operaciones de pegar deben ser iniciadas por el usuario (Ctrl-V, menú pegar).Paste operations need to be user initiated (Ctrl-V, Paste Menu).

  • La copia solo puede realizarse en el contenido seleccionado por el usuario.Copy can only be on user selected content.

  • Al copiar o cortar, el código de confianza parcial coloca el texto sin formato y Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) en el portapapeles.On copy or cut, partial trust code puts plaintext and Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) on to the clipboard. Plaintext incluye texto, texto Unicode, texto de OEM (modelo de intercambio de objetos) y CSV (valores separados por comas).Plaintext includes text, Unicode text, OEM (Object Exchange Model) text, and CSV (Comma-separated values).

  • Al pegar, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) se pegará Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) si el origen de ese contenido procede de un sitio de confianza igual o de más confianza.On paste, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) will paste in Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) if the source of that content is from a equally trusted or more trusted site. Concretamente:Specifically:

    • Una aplicación de confianza parcial puede pegar Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) desde una aplicación de plena confianza.A partial trust application can paste Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) from a full trust application.

    • Una aplicación de confianza parcial puede pegar Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) desde una aplicación de confianza parcial.A partial trust application can paste Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) from a partial trust application.

    • Una aplicación de plena confianza solo puede pegar XAML desde otra aplicación de plena confianza.A full trust application can paste XAML only from another fully trusted application.

    • Una aplicación que no es de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) plena confianza puede examinar el formato ApplicationTrust en el portapapeles y corregir el XAML si es necesario.A non-Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) full trust application can examine the ApplicationTrust format on the clipboard and sanitize the XAML if appropriate.

Métodos

Clear()

Borra los datos del Portapapeles del sistema.Clears any data from the system Clipboard.

ContainsAudio()

Consulta la presencia de datos en el Portapapeles con el formato de datos de WaveAudio.Queries the Clipboard for the presence of data in the WaveAudio data format.

ContainsData(String)

Consulta la presencia de datos con un formato de datos especificado en el Portapapeles.Queries the Clipboard for the presence of data in a specified data format.

ContainsFileDropList()

Consulta la presencia de datos en el Portapapeles con el formato de datos de FileDrop.Queries the Clipboard for the presence of data in the FileDrop data format.

ContainsImage()

Consulta la presencia de datos en el Portapapeles con el formato de datos de Bitmap.Queries the Clipboard for the presence of data in the Bitmap data format.

ContainsText()

Consulta la presencia de datos en el Portapapeles con el formato de UnicodeText.Queries the Clipboard for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat)

Consulta la presencia de datos con un formato de datos de texto en el Portapapeles.Queries the Clipboard for the presence of data in a text data format.

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.Permanently adds the data that is on the Clipboard so that it is available after the data's original application closes.

GetAudioStream()

Devuelve un flujo de datos del Portapapeles con el formato de datos de WaveAudio.Returns a stream of Clipboard data in the WaveAudio data format.

GetData(String)

Recupera los datos con un formato especificado desde el Portapapeles.Retrieves data in a specified format from the Clipboard.

GetDataObject()

Devuelve un objeto de datos que representa todo el contenido del Portapapeles.Returns a data object that represents the entire contents of the Clipboard.

GetFileDropList()

Devuelve una colección de cadenas que contiene una lista de los archivos colocados disponible en el Portapapeles.Returns a string collection that contains a list of dropped files available on the Clipboard.

GetImage()

Devuelve un objeto BitmapSource del Portapapeles que contiene los datos con el formato de Bitmap.Returns a BitmapSource object from the Clipboard that contains data in the Bitmap format.

GetText()

Devuelve una cadena que contiene los datos de UnicodeText del Portapapeles.Returns a string containing the UnicodeText data on the Clipboard.

GetText(TextDataFormat)

Devuelve una cadena que contiene los datos de texto del Portapapeles.Returns a string containing text data on the Clipboard.

IsCurrent(IDataObject)

Compara un objeto de datos especificado con el contenido del Portapapeles.Compares a specified data object to the contents of the Clipboard.

SetAudio(Byte[])

Almacena los datos de audio (formato de datos de WaveAudio ) en el Portapapeles.Stores audio data (WaveAudio data format) on the Clipboard. Los datos de audio se especifican como matriz de bytes.The audio data is specified as a byte array.

SetAudio(Stream)

Almacena los datos de audio (formato de datos de WaveAudio ) en el Portapapeles.Stores audio data (WaveAudio data format) on the Clipboard. Los datos de audio se especifican como secuencia.The audio data is specified as a stream.

SetData(String, Object)

Almacena los datos especificados en el Portapapeles con el formato especificado.Stores the specified data on the Clipboard in the specified format.

SetDataObject(Object)

Coloca un objeto de datos no persistente especificado en el Portapapeles del sistema.Places a specified non-persistent data object on the system Clipboard.

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.Places a specified data object on the system Clipboard and accepts a Boolean parameter that indicates whether the data object should be left on the Clipboard when the application exits.

SetFileDropList(StringCollection)

Almacena los datos de FileDrop en el Portapapeles.Stores FileDrop data on the Clipboard. La lista de archivos colocada se especifica como colección de cadenas.The dropped file list is specified as a string collection.

SetImage(BitmapSource)

Almacena los datos de Bitmap en el Portapapeles.Stores Bitmap data on the Clipboard. Los datos de la imagen se especifican como BitmapSource.The image data is specified as a BitmapSource.

SetText(String)

Almacena los datos de UnicodeText en el Portapapeles.Stores UnicodeText data on the Clipboard.

SetText(String, TextDataFormat)

Almacena los datos de texto en el Portapapeles con un formato de datos de texto especificado.Stores text data on the Clipboard in a specified text data format. Los datos de UnicodeText que se van a almacenar se especifican como cadena.The UnicodeText data to store is specified as a string.

Se aplica a

Consulte también