Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método DataObject.GetData (String, Boolean)

 

Publicado: octubre de 2016

Devuelve los datos asociados con el formato de datos especificado, utilizando un parámetro de conversión automatizada para determinar si se deben convertir los datos a dicho formato.

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

public virtual object GetData(
	string format,
	bool autoConvert
)

Parámetros

format
Type: System.String

Formato de los datos que se van a recuperar. Consulte DataFormats para formatos predefinidos.

autoConvert
Type: System.Boolean

true para convertir los datos al formato especificado; de lo contrario, false.

Valor devuelto

Type: System.Object

Los datos asociados con el formato especificado, o null.

Si el autoConvert parámetro es true y este método no encuentra datos en el formato especificado, intenta convertir los datos en el formato. Si los datos no se puede convertir al formato especificado, o si los datos se almacenaron con la conversión automática establecida en false, este método devuelve null.

Si el autoConvert parámetro es false, este método devuelve los datos en el formato especificado, o null Si no se encuentra ningún dato en este formato.

Para determinar si está asociados a datos o se pueden convertir a un formato, llame a GetDataPresent antes de llamar a GetData. Llame a GetFormats para obtener una lista de formatos válidos para los datos almacenados en este DataObject.

System_CAPS_noteNota

Pueden convertir los datos a otro formato si se han almacenado 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.

Cuando format es Html, este método devuelve una cadena con codificación UTF-8 en aplicaciones destinadas a .NET 4.5 o superior y ANSI cadena codificada en aplicaciones que tienen como destino .NET 4.0 o inferior.

El ejemplo de código siguiente recupera los datos almacenados en un DataObject, mediante el autoConvert para especificar si se debe convertir el formato de datos.

Primero, un nuevo DataObject se crea con datos de texto. A continuación, el ejemplo intenta recuperar los datos, especificando su formato como una cadena y sin conversión de formato, es decir, el autoConvert parámetro es false. Se produce un error en esta operación porque no hay ningún dato de cadena en el DataObject.

A continuación, el ejemplo intenta recuperar los datos de nuevo, con el autoConvert establecido en true. Esta operación se realiza correctamente y se muestran los resultados en un MessageBox.

Este código requiere que textBox1 se ha creado.

private void GetMyData3() {
    // Creates a new data object using a string and the text format.
    string myString = "My new text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);

    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetData("System.String", false) != null) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
       textBox1.Text = "Could not find data of the specified format" + '\n';

    // Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", true).ToString();
 }

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: