IDataObject.GetData Methode

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

Parameters

Retouren

De gegevens die zijn gekoppeld aan de opgegeven indeling of null.

Voorbeelden

In dit voorbeeld wordt de DataObject klasse gebruikt, die wordt geïmplementeerd IDataObject, om het gebruik van de GetData methode te demonstreren. De methode wordt gebruikt voor het ophalen van de gegevens die zijn opgeslagen in myDataObject, die is gekoppeld aan de Text indeling. In het voorbeeld wordt ervan uitgegaan dat u al een Form naam Form1 en een TextBox naam textBox1hebt gemaakt.

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

Opmerkingen

Als deze methode geen gegevens in de opgegeven indeling kan vinden, wordt geprobeerd de gegevens te converteren naar de indeling. Als de gegevens niet naar de opgegeven indeling kunnen worden geconverteerd, retourneert nulldeze methode .

Als u wilt bepalen of gegevens zijn gekoppeld aan of kunnen worden geconverteerd naar een indeling, roept GetDataPresent u aan voordat u aanroept GetData. Een lijst met geldige indelingen aanroepen GetFormats voor de gegevens die in dit exemplaar zijn opgeslagen.

Zie voor een implementatie van deze methode DataObject.GetData.

Zie ook

• 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

Parameters

Retouren

De gegevens die zijn gekoppeld aan de opgegeven indeling of null.

Voorbeelden

In dit voorbeeld wordt de DataObject klasse gebruikt, die wordt geïmplementeerd IDataObject, om het gebruik van de GetData methode te demonstreren. De methode wordt gebruikt voor het ophalen van de gegevens die zijn opgeslagen in myObject, die is gekoppeld aan een specifiek type, myType. Het type opgehaalde gegevens wordt weergegeven in een berichtvak. In het voorbeeld wordt ervan uitgegaan dat u al een Form benoemde naam Form1hebt gemaakt.

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

Opmerkingen

Als deze methode geen gegevens in de opgegeven indeling kan vinden, wordt geprobeerd de gegevens te converteren naar de indeling. Als de gegevens niet naar de opgegeven indeling kunnen worden geconverteerd, retourneert nulldeze methode .

Als u wilt bepalen of gegevens zijn gekoppeld aan of kunnen worden geconverteerd naar een indeling, roept GetDataPresent u aan voordat u aanroept GetData. Een lijst met geldige indelingen aanroepen GetFormats voor de gegevens die in dit exemplaar zijn opgeslagen.

Zie voor een implementatie van deze methode DataObject.GetData.

Zie ook

• 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

Parameters

Retouren

De gegevens die zijn gekoppeld aan de opgegeven indeling of null.

Voorbeelden

In dit voorbeeld wordt de DataObject klasse gebruikt, die wordt geïmplementeerd IDataObject, om het gebruik van de GetData methode te demonstreren. In het voorbeeld worden de gegevens opgehaald die zijn opgeslagen in een DataObject, met behulp van de autoConvert parameter om op te geven of de gegevensindeling al dan niet moet worden geconverteerd. myDataObject Eerst wordt er tekstgegevens gemaakt. Vervolgens probeert het voorbeeld tweemaal om de gegevens op te halen. In de eerste proefversie wordt de indeling opgegeven als een tekenreeks en wordt de autoConvert parameter ingesteld op false. Deze proefversie mislukt en het resultaat wordt weergegeven in een berichtvak met de naam Bericht 1. In de tweede proefversie worden in het voorbeeld dezelfde gegevens opgehaald met de autoConvert parameter die is ingesteld op true. Deze proefversie slaagt en het resultaat wordt weergegeven in een berichtvak met de naam 'Bericht 2'. In het voorbeeld wordt ervan uitgegaan dat u een Form benoemde naam Form1hebt gemaakt.

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

Opmerkingen

Als de autoConvert parameter is true en deze methode geen gegevens in de opgegeven indeling kan vinden, wordt geprobeerd de gegevens te converteren naar de indeling. Als de gegevens niet kunnen worden geconverteerd naar de opgegeven indeling of als de gegevens zijn opgeslagen met de autoConvert parameter die is ingesteld falseop , retourneert nulldeze methode .

Als de autoConvert parameter is false, retourneert deze methode gegevens in de opgegeven indeling of null als er geen gegevens in deze indeling kunnen worden gevonden.

Als u wilt bepalen of gegevens zijn gekoppeld aan of kunnen worden geconverteerd naar een indeling, roept GetDataPresent u aan voordat u aanroept GetData. Een lijst met geldige indelingen aanroepen GetFormats voor de gegevens die in dit exemplaar zijn opgeslagen.

Zie voor een implementatie van deze methode DataObject.GetData.

Zie ook

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