Clipboard.ContainsData(String) Método

  • Referencia

Definición

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

Indica si en el Portapapeles hay datos con el formato especificado o que se puedan convertir a ese formato.

public:
 static bool ContainsData(System::String ^ format);
public static bool ContainsData (string format);
public static bool ContainsData (string? format);
static member ContainsData : string -> bool
Public Shared Function ContainsData (format As String) As Boolean

Parámetros

format
String

Formato de los datos que hay que buscar. Vea DataFormats para obtener los formatos predefinidos.

Devoluciones

Boolean

true si en el Portapapeles haya datos con el formato que especifica el parámetro format o que se puedan convertir a ese formato; de lo contrario, false.

Excepciones

ExternalException

No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.

ThreadStateException

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.

Ejemplos

En el ejemplo siguiente se muestra este miembro.

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}

' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

Comentarios

La DataFormats clase contiene nombres de formato predefinidos que puede usar con este método.

Utilice este método para determinar si el Portapapeles contiene datos en el formato especificado o un formato compatible antes de recuperarlos con el GetData método .

Nota:

Los datos se pueden convertir a otro formato si se almacenó especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.

La clase Clipboard solo se puede usar en subprocesos establecidos en modo de subprocesamiento controlado simple (STA). Para usar esta clase, asegúrese de que el método Main está marcado con el atributo STAThreadAttribute.

Se aplica a

Consulte también