IDataObject.GetData Método

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

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í.

Recupera los datos asociados al formato de datos especificado.

Sobrecargas

GetData(String)	Recupera los datos asociados al formato de datos especificado.
GetData(Type)	Recupera los datos asociados al formato de tipo de clase especificado.
GetData(String, Boolean)	Recupera los datos asociados al formato de datos especificado, usando un tipo booleano para determinar si se deben convertir a dicho formato los datos.

GetData(String)

Recupera los datos asociados al formato de datos especificado.

public:
 System::Object ^ GetData(System::String ^ format);

public object GetData (string format);

public object? GetData (string format);

abstract member GetData : string -> obj

Public Function GetData (format As String) As Object

Parámetros

format: String

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

Devoluciones

Object

Datos asociados al formato especificado o null.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para demostrar el uso del GetData método . El método se usa para recuperar los datos almacenados en myDataObject, que está asociado al Text formato . En el ejemplo se supone que ya ha creado un Form denominado Form1 y un TextBox con nombre textBox1.

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

      // Displays the string in a text box.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
   }

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

    // Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
}

Private Sub GetData1()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Comentarios

Si este método no encuentra datos en el formato especificado, intenta convertir los datos al formato . Si los datos no se pueden convertir al formato especificado, este método devuelve null.

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

Nota

Los datos se pueden convertir a otro formato si se almacenó especificando esa 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.

Para obtener una implementación de este método, vea DataObject.GetData.

Consulte también

Se aplica a

GetData(Type)

Recupera los datos asociados al formato de tipo de clase especificado.

public:
 System::Object ^ GetData(Type ^ format);

public object GetData (Type format);

public object? GetData (Type format);

abstract member GetData : Type -> obj

Public Function GetData (format As Type) As Object

Parámetros

format: Type

Type que representa el formato de los datos que se van a recuperar. Vea DataFormats para obtener los formatos predefinidos.

Devoluciones

Object

Datos asociados al formato especificado o null.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para demostrar el uso del GetData método . El método se usa para recuperar los datos almacenados en myObject, que está asociado a un tipo específico, myType. El tipo de los datos recuperados se muestra en un cuadro de mensaje. En el ejemplo se supone que ya ha creado un Form objeto denominado Form1.

private:
   void GetData2()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;

      // Creates a data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type, myType, to store the type of data.
      Type^ myType = myComponent->GetType();

      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
            MessageBox::Show( "The data type stored in the data object is " +
                  myObject->GetType()->Name + "." );
      else
            MessageBox::Show( "Data of the specified type was not stored in the data object." );
   }

       private void GetData2() 
       {
           // Creates a component.
           Component myComponent = new Component();

           // Creates a data object, and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type, myType, to store the type of data.
           Type myType = myComponent.GetType();

           // Retrieves the data using myType to represent its type.
           Object myObject = myDataObject.GetData(myType);
           if(myObject != null)
               MessageBox.Show("The data type stored in the data object is " +
                   myObject.GetType().Name + ".");
           else
               MessageBox.Show("Data of the specified type was not stored " +
                   "in the data object.");
       }

Private Sub GetData2()
    ' Creates a component.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a data object, and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    ' Creates a type, myType, to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Retrieves the data using myType to represent its type.
    Dim myObject As [Object] = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        MessageBox.Show("The data type stored in the data object is " + myObject.GetType().Name + ".")
    Else
        MessageBox.Show("Data of the specified type was not stored " + "in the data object.")
    End If
End Sub

Comentarios

Si este método no encuentra datos en el formato especificado, intenta convertir los datos al formato . Si los datos no se pueden convertir al formato especificado, este método devuelve null.

Nota

Para obtener una implementación de este método, vea DataObject.GetData.

Consulte también

Se aplica a

GetData(String, Boolean)

Recupera los datos asociados al formato de datos especificado, usando un tipo booleano para determinar si se deben convertir a dicho formato los datos.

public:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);

public object GetData (string format, bool autoConvert);

public object? GetData (string format, bool autoConvert);

abstract member GetData : string * bool -> obj

Public Function GetData (format As String, autoConvert As Boolean) As Object

Parámetros

format: String

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

autoConvert: Boolean

Es true para convertir los datos al formato especificado; en cualquier otro caso, es false.

Devoluciones

Object

Datos asociados al formato especificado o null.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para demostrar el uso del GetData método . En el ejemplo se recuperan los datos almacenados en , DataObjectmediante el autoConvert parámetro para especificar si se va a convertir el formato de datos. En primer lugar, myDataObject se crea con datos de texto. A continuación, el ejemplo intenta recuperar dos veces los datos. En la primera versión de prueba, especifica su formato como una cadena y establece el autoConvert parámetro falseen . Se produce un error en esta versión de prueba y el resultado se muestra en un cuadro de mensaje con la etiqueta "Mensaje n.º 1". En la segunda prueba, el ejemplo recupera los mismos datos con el autoConvert parámetro establecido en true. Esta prueba se realiza correctamente y el resultado se muestra en un cuadro de mensaje con la etiqueta "Mensaje n.º 2". En el ejemplo se supone que ha creado un Form objeto denominado Form1.

private:
   void GetData3()
   {
      // Creates a new data object using a text string.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string with autoConvert equal to false.
      if ( myDataObject->GetData( "System::String", false ) != nullptr )
      {
         // Displays the string in a message box.
         MessageBox::Show( myDataObject->GetData( "System::String", false ) + ".", "Message #1" );
      }
      else
            MessageBox::Show( "Could not find data of the specified format.", "Message #1" );

      // Displays a not found message in a message box.
      // Displays the string in a text box with autoConvert equal to true.
      String^ myData = "The data is " + myDataObject->GetData( "System::String", true ) + ".";
      MessageBox::Show( myData, "Message #2" );
   }

       private void GetData3() 
       {
           // Creates a new data object using a text string.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Displays the string with autoConvert equal to false.
           if (myDataObject.GetData("System.String", false) != null) 
           {
               // Displays the string in a message box.
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString() + ".", "Message #1");
           } 
           else
           {
               // Displays a not found message in a message box.
               MessageBox.Show("Could not find data of the specified format.", "Message #1");
           }

           // Displays the string in a text box with autoConvert equal to true.
           string myData = "The data is " + myDataObject.GetData("System.String", true).ToString() +".";
           MessageBox.Show(myData,"Message #2");
       }

Private Sub GetData3()
    ' Creates a new data object using a text string.
    Dim myString As String = "Hello World!"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string with autoConvert equal to false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Displays the string in a message box.
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
        ' Displays a not found message in a message box.
    Else
        MessageBox.Show("Could not find data of the specified format.", "Message #1")
    End If

    ' Displays the string in a text box with autoConvert equal to true.
    Dim myData As String = "The data is " + myDataObject.GetData("System.String", True).ToString()
    MessageBox.Show(myData, "Message #2")
End Sub

Comentarios

Si el autoConvert parámetro es true y este método no encuentra datos en el formato especificado, intenta convertir los datos al formato . Si los datos no se pueden convertir al formato especificado, o si los datos se almacenaron con el autoConvert parámetro establecido falseen , este método devuelve null.

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

Nota

Para obtener una implementación de este método, vea DataObject.GetData.

Consulte también

Se aplica a

IDataObject.GetData Método

Definición

Sobrecargas

GetData(String)

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

GetData(Type)

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

GetData(String, Boolean)

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Comentarios

Recursos adicionales