IDataObject.GetData Método

Definición

Recupera los datos asociados al formato de datos especificado.Retrieves the data associated with the specified data format.

Sobrecargas

GetData(String)

Recupera los datos asociados al formato de datos especificado.Retrieves the data associated with the specified data format.

GetData(Type)

Recupera los datos asociados al formato de tipo de clase especificado.Retrieves the data associated with the specified class type format.

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.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(String)

Recupera los datos asociados al formato de datos especificado.Retrieves the data associated with the specified data format.

public:
 System::Object ^ GetData(System::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.The format of the data to retrieve. Vea DataFormats para obtener los formatos predefinidos.See DataFormats for predefined formats.

Devoluciones

Datos asociados al formato especificado o null.The data associated with the specified format, or null.

Ejemplos

En este ejemplo se DataObject utiliza la clase, que GetData implementa para mostrar el uso del método. IDataObject,This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. El método se utiliza para recuperar los datos almacenados en myDataObject, que está asociado Text al formato.The method is used to retrieve the data stored in myDataObject, which is associated with the Text format. En el ejemplo se supone que ya ha creado Form un Form1 denominado y TextBox un textBox1denominado.The example assumes that you have already created a Form named Form1 and a TextBox named 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 puede encontrar datos en el formato especificado, intenta convertir los datos al formato.If this method cannot find data in the specified format, it attempts to convert the data to the format. Si los datos no se pueden convertir al formato especificado, este método devuelve null.If the data cannot be converted to the specified format, this method returns null.

Para determinar si los datos están asociados o se pueden convertir a un formato, llame GetDataPresent a antes de llamar GetDataa.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Llame GetFormats a para obtener una lista de formatos válidos para los datos almacenados en esta instancia.Call GetFormats for a list of valid formats for the data stored in this instance.

Nota

Los datos se pueden convertir a otro formato si se almacenaron especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.For example, data stored as Unicode can be converted to text.

Para obtener una implementación de este método, DataObject.GetDatavea.For an implementation of this method, see DataObject.GetData.

Consulte también:

GetData(Type)

Recupera los datos asociados al formato de tipo de clase especificado.Retrieves the data associated with the specified class type format.

public:
 System::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.A Type representing the format of the data to retrieve. Vea DataFormats para obtener los formatos predefinidos.See DataFormats for predefined formats.

Devoluciones

Datos asociados al formato especificado o null.The data associated with the specified format, or null.

Ejemplos

En este ejemplo se DataObject usa la clase, que IDataObjectimplementa, para GetData mostrar el uso del método.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. El método se utiliza para recuperar los datos almacenados en myObject, que está asociado a un tipo específico, myType.The method is used to retrieve the data stored in myObject, which is associated with a specific type, myType. El tipo de los datos recuperados se muestra en un cuadro de mensaje.The type of the retrieved data is displayed in a message box. En el ejemplo se supone que ya ha creado Form un Form1denominado.The example assumes that you have already created a Form named 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 puede encontrar datos en el formato especificado, intenta convertir los datos al formato.If this method cannot find data in the specified format, it attempts to convert the data to the format. Si los datos no se pueden convertir al formato especificado, este método devuelve null.If the data cannot be converted to the specified format, this method returns null.

Para determinar si los datos están asociados o se pueden convertir a un formato, llame GetDataPresent a antes de llamar GetDataa.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Llame GetFormats a para obtener una lista de formatos válidos para los datos almacenados en esta instancia.Call GetFormats for a list of valid formats for the data stored in this instance.

Nota

Los datos se pueden convertir a otro formato si se almacenaron especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.For example, data stored as Unicode can be converted to text.

Para obtener una implementación de este método, DataObject.GetDatavea.For an implementation of this method, see DataObject.GetData.

Consulte también:

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.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

public:
 System::Object ^ GetData(System::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.The format of the data to retrieve. Vea DataFormats para obtener los formatos predefinidos.See DataFormats for predefined formats.

autoConvert
Boolean

Es true para convertir los datos al formato especificado; en cualquier otro caso, es false.true to convert the data to the specified format; otherwise, false.

Devoluciones

Datos asociados al formato especificado o null.The data associated with the specified format, or null.

Ejemplos

En este ejemplo se DataObject usa la clase, que IDataObjectimplementa, para GetData mostrar el uso del método.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. En el ejemplo se recuperan los datos almacenados DataObjecten un, autoConvert utilizando el parámetro para especificar si se debe convertir o no el formato de datos.The example retrieves the data stored in a DataObject, using the autoConvert parameter to specify whether or not to convert the data format. En primer myDataObject lugar, se crea con datos de texto.First, myDataObject is created with text data. A continuación, el ejemplo prueba dos veces para recuperar los datos.Then the example tries twice to retrieve the data. En la primera prueba, especifica su formato como una cadena y establece el autoConvert parámetro en. falseIn the first trial, it specifies its format as a string and sets the autoConvert parameter to false. Esta prueba genera un error y el resultado se muestra en un cuadro de mensaje con la etiqueta "Message #1".This trial fails, and the result is displayed in a message box labeled "Message #1." En la segunda prueba, el ejemplo recupera los mismos datos con el autoConvert parámetro establecido en. trueIn the second trial, the example retrieves the same data with the autoConvert parameter set to true. Esta prueba se realiza correctamente y el resultado se muestra en un cuadro de mensaje con la etiqueta "Message #2".This trial succeeds, and the result is displayed in a message box labeled "Message #2." En el ejemplo se supone que ha creado Form un Form1denominado.The example assumes that you have created a Form named 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 puede encontrar datos en el formato especificado, intenta convertir los datos al formato.If the autoConvert parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. Si los datos no se pueden convertir al formato especificado o si los datos se almacenaron con el autoConvert parámetro establecido en false, este método devuelve null.If the data cannot be converted to the specified format, or if the data was stored with the autoConvert parameter set to false, this method returns null.

Si el autoConvert parámetro es false, este método devuelve los datos en el formato especificado o null si no se puede encontrar ningún dato en este formato.If the autoConvert parameter is false, this method returns data in the specified format, or null if no data in this format can be found.

Para determinar si los datos están asociados o se pueden convertir a un formato, llame GetDataPresent a antes de llamar GetDataa.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Llame GetFormats a para obtener una lista de formatos válidos para los datos almacenados en esta instancia.Call GetFormats for a list of valid formats for the data stored in this instance.

Nota

Los datos se pueden convertir a otro formato si se almacenaron especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.For example, data stored as Unicode can be converted to text.

Para obtener una implementación de este método, DataObject.GetDatavea.For an implementation of this method, see DataObject.GetData.

Consulte también:

Se aplica a