IDataObject.GetData Método

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

Devoluções

Os dados associados ao formato especificado, ou null.

Exemplos

Este exemplo utiliza a DataObject classe, que se IDataObject, aplica para demonstrar o uso do GetData método. O método é usado para recuperar os dados armazenados em myDataObject, que estão associados ao Text formato. O exemplo assume que já criou um Form nome Form1 e um TextBoxtextBox1.

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

Observações

Se este método não conseguir encontrar dados no formato especificado, tenta converter os dados para o formato. Se os dados não puderem ser convertidos para o formato especificado, este método devolve null.

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

Para uma implementação deste método, veja DataObject.GetData.

Ver também

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)

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

Devoluções

Os dados associados ao formato especificado, ou null.

Exemplos

Este exemplo utiliza a DataObject classe, que implementa IDataObject, para demonstrar o uso do GetData método. O método é usado para recuperar os dados armazenados em myObject, que estão associados a um tipo específico, myType. O tipo dos dados recuperados é exibido numa caixa de mensagem. O exemplo assume que já criou 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

Observações

Se este método não conseguir encontrar dados no formato especificado, tenta converter os dados para o formato. Se os dados não puderem ser convertidos para o formato especificado, este método devolve null.

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

Para uma implementação deste método, veja DataObject.GetData.

Ver também

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)

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

Devoluções

Os dados associados ao formato especificado, ou null.

Exemplos

Este exemplo utiliza a DataObject classe, que implementa IDataObject, para demonstrar o uso do GetData método. O exemplo recupera os dados armazenados num DataObject, usando o autoConvert parâmetro para especificar se deve ou não converter o formato dos dados. Primeiro, myDataObject é criado com dados de texto. Depois, o exemplo tenta duas vezes recuperar os dados. Na primeira tentativa, especifica o seu formato como uma cadeia de caracteres e define o autoConvert parâmetro para false. Este teste falha e o resultado é exibido numa caixa de mensagem rotulada "Mensagem #1." No segundo ensaio, o exemplo recupera os mesmos dados com o autoConvert parâmetro definido como true. Este ensaio é bem-sucedido e o resultado é apresentado numa caixa de mensagem rotulada "Mensagem #2." O exemplo assume que criou um Form .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

Observações

Se o autoConvert parâmetro for true e este método não conseguir encontrar dados no formato especificado, tenta converter os dados para o formato. Se os dados não puderem ser convertidos para o formato especificado, ou se os dados foram armazenados com o autoConvert parâmetro definido para false, este método devolve null.

Se o autoConvert parâmetro for false, este método devolve dados no formato especificado, ou null se não houver dados neste formato.

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

Para uma implementação deste método, veja DataObject.GetData.

Ver também

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)