Clipboard.ContainsData(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Indica si hay datos en el Portapapeles que están en el formato especificado o se pueden convertir a ese formato.
public:
static bool ContainsData(System::String ^ format);public static bool ContainsData(string format);static member ContainsData : string -> boolPublic Shared Function ContainsData (format As String) As BooleanParámetros
- format
- String
Formato de los datos que se van a buscar. Consulte DataFormats para conocer los formatos predefinidos.
Devoluciones
true es si hay datos en el Portapapeles que se encuentra en el especificado format o se puede convertir en ese formato; de lo contrario, falsees .
Excepciones
No se pudo borrar el Portapapeles. Esto suele ocurrir cuando otro proceso usa el Portapapeles.
El subproceso actual no está en modo de apartamento de un solo subproceso (STA). Agregue al STAThreadAttribute método de la Main 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.
Use este método para determinar si el Portapapeles contiene datos en el formato especificado o un formato compatible antes de recuperarlo con el GetData método .
Note
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 Clipboard clase solo se puede usar en subprocesos configurados en el modo de apartamento de subproceso único (STA). Para usar esta clase, asegúrese de que el Main método está marcado con el STAThreadAttribute atributo .