IDataObject.GetData Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Recupera os dados associados ao formato de dados especificado.

Sobrecargas

GetData(String)	Recupera os dados associados ao formato de dados especificado.
GetData(Type)	Recupera os dados associados ao formato do tipo de classe especificado.
GetData(String, Boolean)	Recupera os dados associados com o formato de dados especificado, usando um valor booliano para determinar se os dados devem ou não ser convertidos para o formato.

GetData(String)

Recupera os dados associados ao formato de dados 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

O formato dos dados a serem recuperados. Consulte DataFormats para obter os formatos predefinidos.

Retornos

Object

Os dados associados ao formato especificado ou null.

Exemplos

Este exemplo usa a DataObject classe, que implementa IDataObject, para demonstrar o uso do GetData método. O método é usado para recuperar os dados armazenados, myDataObjectque estão associados ao Text formato. O exemplo pressupõe que você já tenha criado um Form nome Form1 e um TextBox nome 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

Comentários

Se esse método não puder encontrar dados no formato especificado, ele tentará converter os dados no formato. Se os dados não puderem ser convertidos no formato especificado, esse método retornará null.

Para determinar se os dados estão associados ou podem ser convertidos em um formato, chame GetDataPresent antes de chamar GetData. Chame GetFormats uma lista de formatos válidos para os dados armazenados nesta instância.

Observação

Os dados poderão ser convertidos em outro formato se forem armazenados especificando se a conversão é permitida e se o formato solicitado for compatível com o formato armazenado. Por exemplo, os dados armazenados como Unicode podem ser convertidos em texto.

Para obter uma implementação desse método, consulte DataObject.GetData.

Confira também

Aplica-se a

GetData(Type)

Recupera os dados associados ao formato do tipo de classe 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

Um Type que representa o formato dos dados a serem recuperados. Consulte DataFormats para obter os formatos predefinidos.

Retornos

Object

Os dados associados ao formato especificado ou null.

Exemplos

Este exemplo usa a DataObject classe, que implementa IDataObject, para demonstrar o uso do GetData método. O método é usado para recuperar os dados armazenados, myObjectque estão associados a um tipo específico. myType O tipo dos dados recuperados é exibido em uma caixa de mensagem. O exemplo pressupõe que você já tenha criado um Form nome 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

Comentários

Observação

Para obter uma implementação desse método, consulte DataObject.GetData.

Confira também

Aplica-se a

GetData(String, Boolean)

Recupera os dados associados com o formato de dados especificado, usando um valor booliano para determinar se os dados devem ou não ser convertidos para o formato.

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

O formato dos dados a serem recuperados. Consulte DataFormats para obter os formatos predefinidos.

autoConvert: Boolean

true para converter os dados para o formato especificado; caso contrário, false.

Retornos

Object

Os dados associados ao formato especificado ou null.

Exemplos

Este exemplo usa a DataObject classe, que implementa IDataObject, para demonstrar o uso do GetData método. O exemplo recupera os dados armazenados em um DataObject, usando o autoConvert parâmetro para especificar se o formato de dados deve ou não ser convertido. Primeiro, myDataObject é criado com dados de texto. Em seguida, o exemplo tenta duas vezes recuperar os dados. Na primeira avaliação, ele especifica seu formato como uma cadeia de caracteres e define o autoConvert parâmetro como false. Essa avaliação falha e o resultado é exibido em uma caixa de mensagem rotulada "Mensagem nº 1". Na segunda avaliação, o exemplo recupera os mesmos dados com o autoConvert parâmetro definido como true. Essa avaliação é bem-sucedida e o resultado é exibido em uma caixa de mensagem rotulada "Mensagem nº 2". O exemplo pressupõe que você tenha criado um Form nome 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

Comentários

Se o autoConvert parâmetro for true e esse método não puder encontrar dados no formato especificado, ele tentará converter os dados no formato. Se os dados não puderem ser convertidos no formato especificado ou se os dados forem armazenados com o autoConvert parâmetro definido como false, esse método retornará null.

Se o autoConvert parâmetro for false, esse método retornará dados no formato especificado ou null se nenhum dado nesse formato puder ser encontrado.

Observação

Para obter uma implementação desse método, consulte DataObject.GetData.

Confira também

Aplica-se a

IDataObject.GetData Método

Definição

Sobrecargas

GetData(String)

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

GetData(Type)

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

GetData(String, Boolean)

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais